MCP

MCP allow AI agents to integrate seamlessly to external data sources and tools.

Synth API MCP is a remote MCP server at https://mcp.synthdata.co/v1/mcp/apikey/json.

There are 2 authentications methods:

• OAuth (coming soon)

• API Key

To authenticate to the MCP with API key, you need to add a custom headers:

• header key: Authorization

• header value: Bearer <your synth api key>

Connect with Claude Desktop

Download the Desktop Extension: synth.mcpb. Double click on the file and Claude Desktop will ask you to install and input your API key.

Connect with Claude Code CLI

Claude Code provide a CLI to use the agentic coding tool of Anthropic. Read more here.

To add the SynthData MCP server, type the command:

claude mcp add --transport http synthdata https://mcp.synthdata.co/v1/mcp/apikey/json --header "Authorization: Bearer <your api key>"

Connect with mcp-remote

mcp-remote is a tool that allow to install a remote MCP server for a local MCP client. It creates a local STDIO MCP to proxies to the remote HTTP Stream Synth MCP. Read more here.

Type the command to add the Synth MCP:

npx -y mcp-remote https://mcp.synthdata.co/v1/mcp/apikey/json --header "Authorization: Bearer <your api key>" --allow-http

Connect with Vercel AI SDK

Vercel AI SDK supports connecting to remote MCP servers. Read more here.

  const mcpClient = await createMCPClient({
    transport: {
      type: "http",
      url: "https://mcp.synthdata.co/v1/mcp/apikey/json",

      headers: { Authorization: `Bearer ${process.env.SYNTH_API_KEY}` },
    },
  });

  const tools = await mcpClient.tools();

  const result = streamText({
    model: gateway(modelId),
    tools,
    system: "You are an agent working with SynthData's MCP.",
    messages: convertToModelMessages(messages),
    onError: (e) => {
      console.error("Error while streaming.", e);
    },
  });

Connect with OpenAI

OpenAI platform allows you to connect to MCP server:

1. go to the Open AI Platform: https://platform.openai.com/chat

2. on the tools configuration, click "Add"

3. chose "MCP server"

4. click on "+ Server" button

5. input the url: https://mcp.synthdata.co/v1/mcp/apikey/json

6. chose a label: synth

7. on authentication, select "Custom headers"

8. type "Authorization" in the header input

9. type "Bearer <your api key>" in the value input, changing with you API key that you create here https://dashboard.synthdata.co/api-keys

10. Click on "Connect"

You can now chat with the LLM and ask for Synth Insights.