SynaBot

SynaBot for Developers

By Mark Barclay · Last updated

Key takeaways

  • •SynaBot exposes an OAuth-protected MCP server so AI agents can query the catalog on your behalf.
  • •API tokens let you build against the same catalog and run assistants programmatically.
  • •Both surfaces respect the same rate limits and token pricing as the web app.
  • •Docs, examples and a token dashboard live on this page.

Two ways to build with SynaBot: a REST API to embed assistants, prompts and tools into your own product, and an OAuth-protected MCP server to plug SynaBot into ChatGPT, Claude, Cursor and any other MCP-compatible AI client.

MCP server
Get a token
REST API
Code examples

SynaBot MCP Server

Connect SynaBot to any Model Context Protocol client — ChatGPT, Claude Desktop, Claude Code, Cursor, Windsurf — and give it live access to SynaBot assistants, prompts, tools, articles, your wallet balance, favorites and chat threads. OAuth 2.1 protected: each user signs in with their own SynaBot account and RLS runs as them.

MCP endpoint
https://synabot.ai/mcp
Auth
OAuth 2.1 with dynamic client registration — no manual key entry.

Available MCP tools

list_assistantsPublic

Browse SynaBot's catalog of specialized AI assistants. Filter by category or keyword.

search_promptsPublic

Search SynaBot's curated library of AI prompts by keyword.

search_toolsPublic

Search SynaBot's directory of AI tools by keyword.

search_articlesPublic

Search SynaBot's published articles and guides.

get_wallet_balanceSigned in

Return the signed-in user's token wallet balance (free + purchased).

list_favoritesSigned in

List the signed-in user's favorited assistants, prompts and tools.

list_chat_threadsSigned in

List the signed-in user's recent SynaBot chat threads.

Connect from your AI client

ChatGPT (Custom Connector)
  1. Settings → Connectors → Add custom connector.
  2. Paste https://synabot.ai/mcp as the server URL.
  3. Sign in with your SynaBot account when prompted.
Claude Desktop / Claude Code

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "synabot": {
      "url": "https://synabot.ai/mcp"
    }
  }
}
Cursor

Settings → MCP → Add new server → paste https://synabot.ai/mcp. Cursor handles the OAuth flow.

Example prompts

Get an API token

For the REST API, create a personal API token below. Send it as a Bearer token on every authenticated request:

Authorization: Bearer syna_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Public catalog endpoints (assistants, prompts, tools) don't require auth. Chat and usage do. Every authenticated call spends tokens from your wallet. (MCP uses OAuth instead — no token needed.)

Loading…

REST API endpoints

GEThttps://synabot.ai/api/public/v1/assistants

List published assistants. Query: q, community, limit, offset.

GEThttps://synabot.ai/api/public/v1/prompts

List published prompts. Query: q, limit, offset.

GEThttps://synabot.ai/api/public/v1/tools

List published AI tools. Query: q, limit, offset.

POSThttps://synabot.ai/api/public/v1/chatBearer

Chat with a specific assistant. Body: { assistant_slug, messages[], stream? }.

GEThttps://synabot.ai/api/public/v1/usageBearer

Get your token wallet balance and recent transactions.

Code examples

Copy-paste snippets to get started in your language of choice.

curl -X POST https://synabot.ai/api/public/v1/chat \
  -H "Authorization: Bearer $SYNABOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_slug": "mark-barclay",
    "messages": [
      { "role": "user", "content": "Give me a 3-step SEO audit for a WP site." }
    ]
  }'

Embed options

Embed any community assistant into your own product or website with the public API. Use streaming chat responses, RAG upload endpoints and usage reporting to build a custom experience around SynaBot.

View API endpoints Custom integration help

Need help?

Join the community forum or contact us if you want a custom integration built for your product.

Visit the forumCustom AI development

Frequently asked questions

How do I authenticate?

The REST API uses personal API tokens (Bearer auth). The MCP server uses OAuth 2.1 with dynamic client registration — sign in with your SynaBot account and grant scopes.

Are there rate limits?

Yes. Free-tier tokens are limited to 60 requests per minute; SynaBot Pro tokens to 600. Rate-limit headers are on every response.

What can I build with the MCP server?

Anything that benefits from SynaBot's catalog inside your AI client — searching prompts from ChatGPT, listing assistants from Claude, checking your wallet from Cursor. Public tools are read-only; authenticated tools act as the signed-in user under RLS.

Is there a rate-limit or usage cost?

Public REST endpoints are free within rate limits. Authenticated endpoints that trigger chat completions spend tokens from the caller's wallet at the standard rate.

Where do I report a bug?

Email hello@synabot.ai with a request ID (returned in every response header) and the failing payload. Bugs affecting paying customers get fixed inside 24 hours.