MCP Tools

2 min readLast updated View as MarkdownAgent setup

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.

ToolWhat it doesArguments
list_organizationsThe 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_projectsThe 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_projectOne project’s settings and store apps, as the public API returns them.projectId; orgId
list_auditsA project’s audit runs, newest first, a page at a time. Filter by status or start time.projectId; limit, cursor, status, startedAfter
get_auditOne audit run: its status, timing and what it covered. Name the project it belongs to.projectId, auditId
list_recommendationsA 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_recommendationOne 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_scoresA project’s score history, newest first, a page at a time. Filter by when the score was computed.projectId; limit, cursor, computedAfter, computedBefore
get_scoreOne score with the provenance of each claim. Name the project it belongs to.projectId, scoreId
list_revisionsA project’s listing revisions, newest first, a page at a time. Filter by store or status.projectId; limit, cursor, store, status
get_revisionOne listing revision. Name the project it belongs to.projectId, revisionId
list_impact_resultsA project’s measured revision impact results, newest first, a page at a time. Filter by revision.projectId; limit, cursor, revisionId
get_impact_resultOne measured impact result with the provenance of each claim. Name the project it belongs to.projectId, impactResultId

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.