docs: correct MCP comparison with the actual 66 read-only tools#46
Merged
Conversation
Connected the official Alegra MCP through claude.ai and inspected every tool: it exposes 66 read-only tools (the earlier '49' came from an incomplete user-pasted list), covering almost the whole API. Corrected the page's 'only in alegra-cli' list — accounting, currencies, sellers, incoming payments, retentions, taxes, ledger categories, and resolutions are READ by the official MCP, not CLI-only. The real difference holds: the MCP reads broadly but writes nothing; alegra-cli reads and writes (plus emission), and still exclusively covers estimates, credit/debit notes, remissions, CFDI, recurring docs, additional charges, and webhooks. EN + ES.
|
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Juan connected the official Alegra MCP through claude.ai, so I could finally inspect every tool hands-on. Two takeaways:
Definitive confirmation it's read-only. All 66 tools are
get/list/search/export — nocreate/update/delete/void/emit/stampanywhere. The "estrictamente de solo lectura" claim is now verified tool-by-tool, not from marketing copy.Our coverage split was wrong. My earlier analysis used a user-pasted list of 49 tools that was incomplete. The real surface (66 tools) reads almost the whole API, including groups the page had listed as alegra-cli-only: accounting (journals, cost centers, ledger), currencies, sellers, incoming payments, retentions, taxes, resolutions. Moved them to "read by both"; fixed the payments note (the MCP reads incoming and outgoing, not just outgoing).
The differentiator is unchanged and cleaner: the MCP reads broadly but writes nothing; alegra-cli reads and writes (+ emission), and still exclusively covers estimates, credit/debit notes, remissions, CFDI, recurring docs, additional charges, and webhooks.
Snapshot refreshed to v0.9.2 + the claude.ai verification method.
mkdocs build --strictpasses. Patch release 0.9.3.