spekoai-mcp

FastMCP v4 server for SpekoAI. The hosted endpoint is:

https://mcp.speko.ai/mcp

It accepts authenticated POST requests using either OAuth or a Speko Platform API key. Configure the URL and let the client negotiate the protocol; do not add protocol headers by hand:

Authorization: Bearer <OAuth access token or sk_live_xxx>
Content-Type: application/json

The transport is stateless and JSON-only. Modern clients use MCP 2026-07-28 directly; handshake-era clients such as Cursor negotiate MCP 2025-11-25 through initialize. Both paths remain sessionless: there is no Mcp-Session-Id, SSE response, local OAuth transaction store, or stdio transport. Better Auth owns authorization, consent, refresh tokens, and client registration; the MCP service only validates signed access tokens per request.

Client setup

Use the direct-HTTP installer and select OAuth (the default interactive choice):

npx @spekoai/mcp@latest init

Or configure an OAuth-capable client directly. For example, Codex reads:

[mcp_servers.speko]
url = "https://mcp.speko.ai/mcp"

For automation, export a Platform API key and add the bearer setting:

[mcp_servers.speko]
url = "https://mcp.speko.ai/mcp"
bearer_token_env_var = "SPEKO_API_KEY"

Tool surfaces

Hosted tool surfaces are bound to hostnames; a profile query parameter is ignored. The primary endpoint exposes operational tools using domain/action names:

• account: organization.get, credits.balance.get, credits.ledger.list, usage.summary.get;
• agents: agents.list, agents.preview_stacks, agents.create, agents.get, agents.update, agents.delete, deployment/version/tool and monitor operations;
• sessions and calls: create, list, inspect, transcript, recording, and test call operations;
• phone numbers, including bringing your own carrier: phone_numbers.sip_connections.create connects a customer SIP trunk and phone_numbers.import attaches a number that rides it, with no SIP gateway or support ticket;
• verified caller IDs: phone_numbers.verified_caller_ids.start sends a code to a number the user already has and .confirm submits it, after which sessions.phone.create accepts that number as from; .list and .release. Start, confirm and release need an OAuth sign-in as a workspace owner or admin;
• custom voices: voice_clones.create clones a voice from a recording link onto ElevenLabs, Cartesia, MiniMax or CSM, and its provider voice id works with audio.synthesize; voice_clones.list, .provision and .delete;
• knowledge bases, evals, migration helpers, audio helpers, and docs.search.

Builder profile

App builders use the curated host at:

https://builder-mcp.speko.ai/mcp

It contains docs search, catalogs, agent reads, stack preview, integration code snippets, the test-call review path, and the limited agents.create and agents.test_call writes. Generated applications use Speko SDKs at runtime; they do not call MCP tools.

Replit profile

Replit uses its own host:

https://replit.speko.ai/mcp

It serves 28 tools in build-time order — code_snippets.get, the voice and model catalogs, docs search and stack preview come first, then agent, number and transcript reads, then the writes. It adds the two paths the builder profile omits: knowledge bases, so a voice FAQ has somewhere to keep the FAQ, and phone numbers, which is the next ask after a working in-app assistant. Gateway operations, evals, monitors, scenarios, billing, API keys, migrations and every destructive delete stay out.

Assistant directory hosts

Assistant directories are published on their own hosts, each shaped by that directory's policy. The surface is a property of the host: there is no query parameter, header, or account setting that widens it.

Anthropic MCP Directory

https://anthropic.speko.ai/mcp

Reads across the a

... View full README on GitHub