---
title: Submo API docs — submoapp.com developer portal
description: Submo API, MCP servers, and auth for subscription research and tracking.
canonical: https://submoapp.com/developers
last-updated: 2026-08-24
---
# Submo API docs (submoapp.com)

One versioned contract at `/v1`. Both hosted MCP servers call the same endpoints.

- Submo OpenAPI spec: https://submoapp.com/openapi.json
- Submo MCP: https://api.submoapp.com/mcp (also https://mcp.submoapp.com)
- Submo research MCP, no key: https://api.submoapp.com/mcp/docs
- Submo MCP server card: https://submoapp.com/.well-known/mcp/server-card.json
- Auth: https://submoapp.com/auth.md
- Skill: https://submoapp.com/SKILL.md
- Agent rules: https://submoapp.com/AGENTS.md
- Docs index: https://submoapp.com/docs/llms.txt
- Source: https://github.com/selimhancakir/submo

Public research needs no key. Managing subscriptions needs a paid API key from Account or agent checkout.

Errors are JSON on every 4xx/5xx: `{ "error": { "code", "message", "hint", "docs_url" } }`.
No webhooks — poll `GET /v1/scans/{id}` after a 202.