MCP Tools
What the client can read
The tools mirror the Public API: each project tool is a Public API operation, takes the same parameters and returns the same data, with the same provenance on recommendations, scores and impact results.
Each tool’s arguments list the required ones first, then the optional ones after the semicolon.
| Tool | What it does | Arguments |
|---|---|---|
list_organizations | The Apptonomy organizations you belong to, your role in each, and whether an owner or manager has granted this AI client access there. Name an organization from this list in the other tools. | none |
list_projects | The projects of one organization that this AI client’s grant lets you read, by name, a page at a time. Needs the organization’s grant for this client. | orgId; limit, cursor |
get_project | One project’s settings and store apps, as the public API returns them. | projectId; orgId |
list_audits | A project’s audit runs, newest first, a page at a time. Filter by status or start time. | projectId; limit, cursor, status, startedAfter |
get_audit | One audit run: its status, timing and what it covered. Name the project it belongs to. | projectId, auditId |
list_recommendations | A project’s recommendations, newest first, a page at a time. Filter by the audit that produced them, workflow status (unresolved: open, accepted or deferred) or priority. Rows sharing a stableKey are one recommendation seen by several audits. | projectId; limit, cursor, auditId, status, priority |
get_recommendation | One recommendation with the provenance of each claim: the sources it rests on and when they were observed. Name the project it belongs to. | projectId, recommendationId |
list_scores | A project’s score history, newest first, a page at a time. Filter by when the score was computed. | projectId; limit, cursor, computedAfter, computedBefore |
get_score | One score with the provenance of each claim. Name the project it belongs to. | projectId, scoreId |
list_revisions | A project’s listing revisions, newest first, a page at a time. Filter by store or status. | projectId; limit, cursor, store, status |
get_revision | One listing revision. Name the project it belongs to. | projectId, revisionId |
list_impact_results | A project’s measured revision impact results, newest first, a page at a time. Filter by revision. | projectId; limit, cursor, revisionId |
get_impact_result | One measured impact result with the provenance of each claim. Name the project it belongs to. | projectId, impactResultId |
list_release_notes | What shipped in Apptonomy itself: one entry per production release, newest first, with its date, version and user-facing changes, a page at a time. Filter by deployment time. Needs no organization. | optional: limit, cursor, deployedAfter, deployedBefore |
Lists take limit (1–100, default 25) and cursor, exactly as the API does. Daily store analytics and proceeds are not available through MCP; use the Public API.