submitr

An MCP client that quotes a project submission against submitr's hosted directory-matching service from a single JSON manifest. Describe your project once — name, URL, tagline, categories — and submitr matches it against connected directories and prices the submission. One manifest, many directories.

Status: quoting only — hosted submission tools are not forwarded by this package

[email protected] is a thin stdio→HTTPS proxy in front of the hosted submitr service. It forwards quote_submission to https://api.submitr.dev and returns whatever the hosted service says, including a quote_id for that quote (a 30-minute binding offer).

submit and submission_status are registered tools, but calling either one returns a structured error — { "error": "not_available_in_this_build", "message": "..." } — not a stack trace and not a silent no-op. The hosted submission loop shipped in Phase 2 and is live on the Worker; this stdio proxy does not forward those calls.

If you're upgrading from [email protected]: that version ran a local, unbilled submit against a small built-in directory registry, backed by a SQLite file on disk. This release removes that local server entirely — there is no flag to bring it back, and no local database, adapters, or job queue ship in this package anymore. Use the remote MCP endpoint when you need the hosted submit and submission_status tools.

Install

The package name is submitr; its bin (submitr) runs dist/index.js as a stdio MCP proxy.

Via the Claude Code CLI:

claude mcp add --transport stdio submitr -- npx -y submitr

Or a .mcp.json / generic MCP client config (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "submitr": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "submitr"]
    }
  }
}

Tools

quote_submission({ manifest, policy? })

Match a project manifest against connected directories and return candidates with prices, authority scores and expected review times. This forwards the request to the hosted submitr service and returns its response verbatim, including a quote_id.

policy (optional) narrows the match: max_budget_usd, price_ceiling_per_directory, min_authority_score, blocked_directories.

submit({ quote_id, selection })

Not available in this release. Returns a structured not_available_in_this_build error. This package does not forward the hosted contract; use the remote MCP endpoint with the founder-approved quote_id and selection.

submission_status({ submission_id } | { group_id })

Not available in this release. Returns a structured not_available_in_this_build error, same as submit. The hosted contract accepts exactly one of submission_id or group_id; use the remote MCP endpoint for it.

The manifest

The manifest is the input to quote_submission. The full JSON Schema ships as the sibling @submitr/schema package (manifest.schema.json, CC0) in this monorepo, so other tools can implement the same contract without depending on submitr itself.

{
  "manifest_version": "1",
  "name": "RepoRadar",
  "url": "https://reporadar.dev",
  "tagline": "Find trending open-source repos before they trend",
  "description": "RepoRadar watches GitHub activity signals — commit velocity, contributor growth, issue sentiment — and surfaces repos that are about to take off. Built for developer-tool founders, investors, and OSS maintainers who want to be early instead of surprised.",
  "categories": ["devtools", "data"],
  "pricing_model": "freemium",
  "launched_at": "2026-07-14",
  "contact_email": "[email protected]",
  "logo_url": "https://reporadar.dev/logo.png",
  "screenshot_urls": ["https://reporadar.dev/shots/dashboard.png"],
  "founder_name": "Jane Doe",
  "links": {
    "github": "https://github.com/reporadar",
    "x": "https://x.com/reporadar"
  },
  "policy": {
    "max_budget_usd": 25,
    "price_ceiling_per_directory": 5,
    "min_authority_score": 40,
    "blocked_directories": []
  },
  "submitter_identity": "pay.cloudflare.com/jane-doe"
}

name, url (must be https://), tagline, description, categories, and contact_email are required; everything else is optional.

Environment variables

| Variable | Purpose | |---|---| | SUBMITR_API_BASE_URL | Overrides the hosted service quote_submission forwards to. Defaults to https://api.submitr.dev. |

License

Apache-2.0