Client setup

Spectre works with any MCP-compatible client. Choose your client below and follow the setup path that matches your tool.

Claude (web & mobile)

Claude supports OAuth-connected MCP servers. This is the fastest path — no API key, no config file.

1. Open Claude → Settings → Connectors → Add custom connector.
2. Paste the Spectre MCP URL:

3. An OAuth prompt appears. Approve it.
4. Spectre is now connected. Claude will automatically discover and use Spectre tools when your prompt requires LinkedIn data.

Claude Desktop

Claude Desktop connects to MCP servers through a configuration file. Add Spectre to your claude_desktop_config.json:

1. Generate an API key from your dashboard.
2. Open your Claude Desktop config file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
3. Add the Spectre server entry under mcpServers:

{
  "mcpServers": {
    "spectre": {
      "url": "https://mcp.spectremcp.site",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

4. Restart Claude Desktop. Spectre tools will appear automatically.

Claude Code

Claude Code connects to MCP servers through its CLI. Add Spectre with the mcp add command:

1. Generate an API key from your dashboard.
2. Register Spectre as an MCP server:

claude mcp add spectre --url https://mcp.spectremcp.site --header "Authorization: Bearer sk_live_your_key_here"

3. Alternatively, add it to your Claude Code config file directly — same JSON shape as Claude Desktop above.

Cursor

Cursor supports MCP servers via its settings. Add Spectre under MCP Servers in Cursor Settings, or edit .cursor/mcp.json in your project:

{
  "mcpServers": {
    "spectre": {
      "url": "https://mcp.spectremcp.site",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

Restart Cursor after adding the config. Spectre tools will be available in Composer and Agent mode.

Other MCP clients

Spectre works with any client that implements the Model Context Protocol. The config shape is always the same — a URL and an Authorization header:

{
  "mcpServers": {
    "spectre": {
      "url": "https://mcp.spectremcp.site",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

If your client does not support custom headers, use the query-parameter method:

https://mcp.spectremcp.site?key=sk_live_your_key_here

Direct API (no MCP client)

You can call Spectre tools directly over HTTP without an MCP client. This is useful for scripting, testing, or integrating into non-MCP applications.

First, call initialize to get a session ID (no auth required):

curl -X POST https://mcp.spectremcp.site \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Then call a tool using the session ID and your API key:

curl -X POST https://mcp.spectremcp.site \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -H "Mcp-Session-Id: YOUR_SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_person_profile","arguments":{"linkedin_username":"williamhgates"}}}'