MCP
Connect AI agents directly to Owlmetry via the Model Context Protocol — the recommended path for coding agents. No CLI installation needed.
The Owlmetry MCP endpoint lets AI agents connect directly to your Owlmetry server over HTTP. Instead of installing the CLI and keeping it up to date, agents configure a URL once and always get the latest tools — every deploy is instantly live.
Recommended for AI agents. If your coding agent supports MCP (Claude Code, Cursor, VS Code Copilot, Windsurf, Zed, JetBrains, Cline, Roo Code), use the MCP endpoint instead of the CLI. No installation, no updates, 69 tools available instantly.
Ready to connect? Jump to Setup for editor-specific configuration.
The endpoint exposes 69 tools covering the same capabilities as the CLI: managing projects, apps, metrics, and funnels; querying events and analytics; triaging issues, feedback, and attachments; running integrations and background jobs; ranking ad campaigns by revenue; tracking App Store ratings + reviews; and viewing audit logs.
How it works
The MCP endpoint lives at /mcp on your Owlmetry API server. It uses the Streamable HTTP transport in stateless JSON mode — each request is independent, no session management needed.
Agents authenticate with an owl_agent_* API key passed as a Bearer token. The endpoint forwards each tool call to the corresponding REST route internally, so all existing permission checks and validation apply.
Unlike the CLI (which requires npm install, periodic updates, and an interactive login flow), the MCP endpoint needs only a URL and an API key pasted into your editor's config file once.
Available tools
| Domain | Tools | Count |
|---|---|---|
| Auth | whoami, create-import-key | 2 |
| Projects | list-projects, get-project, create-project, update-project | 4 |
| Apps | list-apps, get-app, create-app, update-app, list-app-users | 5 |
| Events | query-events, get-event, investigate-event | 3 |
| Metrics | list-metrics, get-metric, create-metric, update-metric, delete-metric, query-metric, list-metric-events | 7 |
| Funnels | list-funnels, get-funnel, create-funnel, update-funnel, delete-funnel, query-funnel | 6 |
| Issues | list-issues, get-issue, resolve-issue, silence-issue, snooze-issue, reopen-issue, claim-issue, merge-issues, list-issue-comments, add-issue-comment | 10 |
| Feedback | list-feedback, get-feedback, update-feedback-status, add-feedback-comment | 4 |
| Attachments | list-attachments, get-attachment, delete-attachment, get-project-attachment-usage | 4 |
| Integrations | list-providers, list-integrations, add-integration, update-integration, remove-integration, sync-integration, copy-integration, get-revenuecat-webhook-setup | 8 |
| Jobs | list-jobs, get-job, trigger-job, cancel-job | 4 |
| Audit Logs | list-audit-logs | 1 |
| Ads | list-ad-campaigns, list-ad-groups, list-ad-leaves, sync-ads | 4 |
| Ratings | list-app-ratings, list-ratings-by-country, sync-app-ratings | 3 |
| Reviews | list-reviews, get-review, respond-to-review, delete-review-response | 4 |
Agent resources
The server also exposes MCP resources that clients can read on connection:
| URI | Description |
|---|---|
owlmetry://guide | Operational guide — concepts, resource hierarchy, workflows, and conventions |
SDK integration guides (Swift, Node.js, CLI) are distributed as a separate Claude Code plugin marketplace. Install inside Claude Code with /plugin marketplace add owlmetry/owlmetry-skills.