01

Quickstart

SparkRaise supports both remote OAuth for marketplace clients and manual bearer tokens for local stdio hosts.

  1. 1.For ChatGPT / Apps Marketplace, point the client at https://mcp.sparkraise.ai/.well-known/mcp.json and complete the OAuth prompt.
  2. 2.For Claude Desktop or local MCP hosts, sign in at sparkraise.ai and mint a bearer token.
  3. 3.Use the manual config below only for local stdio hosts.
claude_desktop_config.jsonJSON
{
  "mcpServers": {
    "sparkraise": {
      "command": "npx",
      "args": ["-y", "@sparkraise/mcp"],
      "env": {
        "SPARKRAISE_TOKEN": "sr_live_••••••••"
      }
    }
  }
}

Remote clients should prefer the streamable-http endpoint and OAuth discovery instead of embedding a long-lived token.

02

Authentication

Streamable-http clients authenticate with OAuth 2.1 authorization-code + PKCE. Manual bearer tokens remain available for local stdio MCP hosts and direct REST use.

MARKETPLACE OAUTH

Recommended for ChatGPT and other remote MCP clients. Uses dynamic client registration, PKCE, and revocation at /api/oauth/revoke.

MANUAL BEARER TOKEN

Fallback for local stdio hosts like Claude Desktop. Mint separately and pass via SPARKRAISE_TOKEN.

Free tier rate limits60 search calls / hour · 1,000 calls / day. Sufficient for human-driven agent workflows. Higher limits bundled with premium listings.
03

Tools Reference

Core tools available via MCP. Full schema at MCP-TOOLS.md (coming soon).

search_companiesFull-text + filter search across published listings
get_companyRetrieve a single company profile by slug
list_raising_nowCompanies with an open raise, sorted by momentum
upsert_listingCreate or update a listing (write token required)
add_metricsAppend a metrics period to a listing
add_monitoring_targetRegister a URL for ongoing monitoring
watchAdd a company to your watchlist
request_introductionSend a one-time intro email to the founder
whoamiConfirm token identity and scopes
04

REST API Mirror

Every MCP tool has a REST equivalent at /api/v1/<tool_name>. Same zod schemas, same response shape. Bearer token authentication.

POST/api/v1/search_companiesJSON body with SearchParams. Returns {results, count, _disclaimer}
GET/api/v1/get_company/:slugReturns {company, _disclaimer}. 404 if not found.
Response envelopeAll responses include a _disclaimer field: “Information only. Not investment advice.” — so agent-rendered output picks it up automatically.