Context API MCP Server

MCP (Model Context Protocol) server to access the doppelgangers.ai Social Media Context API.

This MCP server provides access to contextualized renderings (XML descriptions) of Twitter/X posts. The contextualization allows for:

More high-quality retrieval of relevant information from the posts,
More high-quality analysis of insights, trends, topics, etc. from the posts

The contextualization is achieved by adding the following information to the XML description of each post:

Descriptions of referenced posts and images
When the post is a reply in a conversation, the conversation or a summary of the conversation.
Metadata about the post (e.g., creation data, post ID, etc.)

Note that no descriptions are added yet related to referenced videos or links (external sites).

The XML structure helps to describe the relationship between posts and their context.

Using the available tools has a cost associated with it, with each call the credit balance is updated.

Features

search_relevant_posts: Semantic search of contextualized post renderings of a certain Twitter/X user, based on a natural language queries like "What does @visionscaper think about the future of AI?".
get_all_user_posts: Retrieve all contextualized post renderings of a specific Twitter/X user. This is useful to analyse the posts for insights, trends and topics over all posts.
check_credits: View your API credit balance and usage.

Installation

1. Get your API Key

Request an API key at dev.doppelgangers.ai:3003 or via the API:

curl -X POST https://dev.doppelgangers.ai:3003/auth/request-key \
  -H "Content-Type: application/json" \
  -d '{"email": "your@email.com", "name": "Your Name"}'

2. Configure Your Client

Add the following config to your MCP client:

{
  "mcpServers": {
    "context-api": {
      "command": "npx",
      "args": ["-y", "context-api-mcp"],
      "env": {
        "CONTEXT_API_KEY": "your-api-key-here"
      }
    }
  }
}

MCP Client configuration

Amp

Follow Amp's MCP guide and use the config provided above. You can also install the Context API MCP server using the CLI:

amp mcp add context-api -- npx context-api-mcp

Antigravity

To use the Context API MCP server follow the instructions from Antigravity's docs to install a custom MCP server. Add the following config to the MCP servers config:

{
  "mcpServers": {
    "context-api": {
      "command": "npx",
      "args": ["-y", "context-api-mcp"],
      "env": {
        "CONTEXT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Note: If you encounter an "EOF" error, try using the absolute path to npx (e.g., /usr/local/bin/npx) or invoke the CLI script directly via node.

Claude Code

Use the Claude Code CLI to add the Context API MCP server (guide):

claude mcp add context-api npx context-api-mcp

Claude Desktop

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the Context API MCP server:

{
  "mcpServers": {
    "context-api": {
      "command": "npx",
      "args": ["-y", "context-api-mcp"],
      "env": {
        "CONTEXT_API_KEY": "your-api-key-here"
      }
    }
  }
}

After updating the configuration, restart Claude Desktop for changes to take effect.

Cline

Follow Cline's MCP guide and use the config provided above.

Codex

Follow the configure MCP guide using the standard config from above. You can also install the Context API MCP server using the Codex CLI:

codex mcp add context-api -- npx context-api-mcp

Copilot CLI

Start Copilot CLI:

copilot

Start the dialog to add a new MCP server by running:

/mcp add

Configure the following fields and press CTRL+S to save the configuration:

Server name: context-api
Server Type: [1] Local
Command: npx -y context-api-mcp

Copilot / VS Code

Follow the MCP install guide, with the standard config from above. You can also install the Context API MCP server using the VS Code CLI:

code --add-mcp '{"name":"context-api","command":"npx","args":["-y","context-api-mcp"],"env":{"CONTEXT_API_KEY":"your-api-key-here"}}'

Cursor

Open Cursor Settings
Go to Features > MCP
Click + Add New MCP Server
Enter the following details:
- Name: Context API
- Type: command
- Command: npx -y context-api-mcp
Add your API key in the environment variables section if supported, or ensure it's set in your system environment.

Factory CLI

Use the Factory CLI to add the Context API MCP server (guide):

droid mcp add context-api "npx -y context-api-mcp"

Gemini CLI

Install the Context API MCP server using the Gemini CLI.

Project wide:

gemini mcp add context-api npx context-api-mcp

Globally:

gemini mcp add -s user context-api npx context-api-mcp

Alternatively, follow the MCP guide and use the standard config from above.

Gemini Code Assist

Follow the configure MCP guide using the standard config from above.

JetBrains AI Assistant & Junie

Kiro

In Kiro Settings, go to Configure MCP > Open Workspace or User MCP Config > Use the configuration snippet provided above.

Or, from the IDE Activity Bar > Kiro > MCP Servers > Click Open MCP Config. Use the configuration snippet provided above.

Qoder

In Qoder Settings, go to MCP Server > + Add > Use the configuration snippet provided above.

Alternatively, follow the MCP guide and use the standard config from above.

Qoder CLI

Install the Context API MCP server using the Qoder CLI (guide):

Project wide:

qodercli mcp add context-api -- npx context-api-mcp

Globally:

qodercli mcp add -s user context-api -- npx context-api-mcp

Visual Studio

Follow the Visual Studio MCP documentation to add the server using the standard config from above.

Warp

Go to Settings | AI | Manage MCP Servers -> + Add to add an MCP Server. Use the config provided above.

Windsurf

Follow the configure MCP guide using the standard config from above.

Zed

Edit your Zed settings file (settings.json):

{
  "mcp": {
    "servers": {
      "context-api": {
        "command": "npx",
        "args": ["-y", "context-api-mcp"],
        "env": {
          "CONTEXT_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

Usage Examples

Once configured, you can use the tools in your MCP client:

Search Relevant Posts

Semantic search of contextualized post renderings of a certain Twitter/X user, based on a natural language query.

What does @elonmusk think about AI regulation?

Get All User Posts

Retrieve all contextualized post renderings of a specific Twitter/X user. This tool is useful when you need to analyse posts for insights, trends and topics over all posts.

What has recently been the mood of @elonmusk?

Check Credits

Check your Context API credit balance and usage statistics.

How many API credits do I have left?

Tool Reference

search_relevant_posts

Semantic search of contextualized post renderings of a certain Twitter/X user, based on a natural language query. Use this tool to find specific posts, relevant to the query.

Parameter	Type	Required	Description
query	string	Yes	Natural language search query
username	string	Yes	Twitter/X username (without @)
platform	string	No	Platform (default: "X")

get_all_user_posts

Retrieve all contextualized post renderings of a specific Twitter/X user. This tool is useful when you need to analyse posts for insights, trends and topics over all posts.

Parameter	Type	Required	Description
username	string	Yes	Twitter/X username (without @)
platform	string	No	Platform (default: "X")
simple	boolean	No	If true, returns simplified post renderings without metadata
limit	number	No	Max results to return (default: all)
offset	number	No	Pagination offset (default: 0)

check_credits

Check your Context API credit balance and usage statistics. No parameters required.

Environment Variables

Variable	Required	Default	Description
CONTEXT_API_KEY	Yes	-	Your Context API key
CONTEXT_API_URL	No	https://dev.doppelgangers.ai:3003	API base URL (optional)

Troubleshooting

Server not showing in Client

Ensure you have Node.js 18+ installed
Check that CONTEXT_API_KEY is set correctly
Restart your client completely

API errors

Check the client logs for detailed error messages. The server outputs to stderr to avoid interfering with the MCP protocol.

Test the server manually

CONTEXT_API_KEY=your-key npx context-api-mcp

Development

To run the server from source:

Clone the repository
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```
Run the server:
```
node dist/index.js
```

Context API MCP Server

MCP (Model Context Protocol) server to access the doppelgangers.ai Social Media Context API.

This MCP server provides access to contextualized renderings (XML descriptions) of Twitter/X posts. The contextualization allows for:

More high-quality retrieval of relevant information from the posts,
More high-quality analysis of insights, trends, topics, etc. from the posts

The contextualization is achieved by adding the following information to the XML description of each post:

Descriptions of referenced posts and images
When the post is a reply in a conversation, the conversation or a summary of the conversation.
Metadata about the post (e.g., creation data, post ID, etc.)

Note that no descriptions are added yet related to referenced videos or links (external sites).

The XML structure helps to describe the relationship between posts and their context.

Using the available tools has a cost associated with it, with each call the credit balance is updated.

Features

search_relevant_posts: Semantic search of contextualized post renderings of a certain Twitter/X user, based on a natural language queries like "What does @visionscaper think about the future of AI?".
get_all_user_posts: Retrieve all contextualized post renderings of a specific Twitter/X user. This is useful to analyse the posts for insights, trends and topics over all posts.
check_credits: View your API credit balance and usage.

Installation

1. Get your API Key

Request an API key at dev.doppelgangers.ai:3003 or via the API:

curl -X POST https://dev.doppelgangers.ai:3003/auth/request-key \
  -H "Content-Type: application/json" \
  -d '{"email": "your@email.com", "name": "Your Name"}'

2. Configure Your Client

Add the following config to your MCP client:

{
  "mcpServers": {
    "context-api": {
      "command": "npx",
      "args": ["-y", "context-api-mcp"],
      "env": {
        "CONTEXT_API_KEY": "your-api-key-here"
      }
    }
  }
}

MCP Client configuration

Amp

Follow Amp's MCP guide and use the config provided above. You can also install the Context API MCP server using the CLI:

amp mcp add context-api -- npx context-api-mcp

Antigravity

To use the Context API MCP server follow the instructions from Antigravity's docs to install a custom MCP server. Add the following config to the MCP servers config:

{
  "mcpServers": {
    "context-api": {
      "command": "npx",
      "args": ["-y", "context-api-mcp"],
      "env": {
        "CONTEXT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Note: If you encounter an "EOF" error, try using the absolute path to npx (e.g., /usr/local/bin/npx) or invoke the CLI script directly via node.

Claude Code

Use the Claude Code CLI to add the Context API MCP server (guide):

claude mcp add context-api npx context-api-mcp

Claude Desktop

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the Context API MCP server:

{
  "mcpServers": {
    "context-api": {
      "command": "npx",
      "args": ["-y", "context-api-mcp"],
      "env": {
        "CONTEXT_API_KEY": "your-api-key-here"
      }
    }
  }
}

After updating the configuration, restart Claude Desktop for changes to take effect.

Cline

Follow Cline's MCP guide and use the config provided above.

Codex

Follow the configure MCP guide using the standard config from above. You can also install the Context API MCP server using the Codex CLI:

codex mcp add context-api -- npx context-api-mcp

Copilot CLI

Start Copilot CLI:

copilot

Start the dialog to add a new MCP server by running:

/mcp add

Configure the following fields and press CTRL+S to save the configuration:

Server name: context-api
Server Type: [1] Local
Command: npx -y context-api-mcp

Copilot / VS Code

Follow the MCP install guide, with the standard config from above. You can also install the Context API MCP server using the VS Code CLI:

code --add-mcp '{"name":"context-api","command":"npx","args":["-y","context-api-mcp"],"env":{"CONTEXT_API_KEY":"your-api-key-here"}}'

Cursor

Open Cursor Settings
Go to Features > MCP
Click + Add New MCP Server
Enter the following details:
- Name: Context API
- Type: command
- Command: npx -y context-api-mcp
Add your API key in the environment variables section if supported, or ensure it's set in your system environment.

Factory CLI

Use the Factory CLI to add the Context API MCP server (guide):

droid mcp add context-api "npx -y context-api-mcp"

Gemini CLI

Install the Context API MCP server using the Gemini CLI.

Project wide:

gemini mcp add context-api npx context-api-mcp

Globally:

gemini mcp add -s user context-api npx context-api-mcp

Alternatively, follow the MCP guide and use the standard config from above.

Gemini Code Assist

Follow the configure MCP guide using the standard config from above.

JetBrains AI Assistant & Junie

Kiro

In Kiro Settings, go to Configure MCP > Open Workspace or User MCP Config > Use the configuration snippet provided above.

Or, from the IDE Activity Bar > Kiro > MCP Servers > Click Open MCP Config. Use the configuration snippet provided above.

Qoder

In Qoder Settings, go to MCP Server > + Add > Use the configuration snippet provided above.

Alternatively, follow the MCP guide and use the standard config from above.

Qoder CLI

Install the Context API MCP server using the Qoder CLI (guide):

Project wide:

qodercli mcp add context-api -- npx context-api-mcp

Globally:

qodercli mcp add -s user context-api -- npx context-api-mcp

Visual Studio

Follow the Visual Studio MCP documentation to add the server using the standard config from above.

Warp

Go to Settings | AI | Manage MCP Servers -> + Add to add an MCP Server. Use the config provided above.

Windsurf

Follow the configure MCP guide using the standard config from above.

Zed

Edit your Zed settings file (settings.json):

{
  "mcp": {
    "servers": {
      "context-api": {
        "command": "npx",
        "args": ["-y", "context-api-mcp"],
        "env": {
          "CONTEXT_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

Usage Examples

Once configured, you can use the tools in your MCP client:

Search Relevant Posts

Semantic search of contextualized post renderings of a certain Twitter/X user, based on a natural language query.

What does @elonmusk think about AI regulation?

Get All User Posts

Retrieve all contextualized post renderings of a specific Twitter/X user. This tool is useful when you need to analyse posts for insights, trends and topics over all posts.

What has recently been the mood of @elonmusk?

Check Credits

Check your Context API credit balance and usage statistics.

How many API credits do I have left?

Tool Reference

search_relevant_posts

Semantic search of contextualized post renderings of a certain Twitter/X user, based on a natural language query. Use this tool to find specific posts, relevant to the query.

Parameter	Type	Required	Description
query	string	Yes	Natural language search query
username	string	Yes	Twitter/X username (without @)
platform	string	No	Platform (default: "X")

get_all_user_posts

Retrieve all contextualized post renderings of a specific Twitter/X user. This tool is useful when you need to analyse posts for insights, trends and topics over all posts.

Parameter	Type	Required	Description
username	string	Yes	Twitter/X username (without @)
platform	string	No	Platform (default: "X")
simple	boolean	No	If true, returns simplified post renderings without metadata
limit	number	No	Max results to return (default: all)
offset	number	No	Pagination offset (default: 0)

check_credits

Check your Context API credit balance and usage statistics. No parameters required.

Environment Variables

Variable	Required	Default	Description
CONTEXT_API_KEY	Yes	-	Your Context API key
CONTEXT_API_URL	No	https://dev.doppelgangers.ai:3003	API base URL (optional)

Troubleshooting

Server not showing in Client

Ensure you have Node.js 18+ installed
Check that CONTEXT_API_KEY is set correctly
Restart your client completely

API errors

Check the client logs for detailed error messages. The server outputs to stderr to avoid interfering with the MCP protocol.

Test the server manually

CONTEXT_API_KEY=your-key npx context-api-mcp

Development

To run the server from source:

Clone the repository
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```
Run the server:
```
node dist/index.js
```

Context API MCP Server

Context API MCP Server

Features

Installation

1. Get your API Key

2. Configure Your Client

MCP Client configuration

Usage Examples

Search Relevant Posts

Get All User Posts

Check Credits

Tool Reference

search_relevant_posts

search_relevant_posts

get_all_user_posts

check_credits

Environment Variables

Troubleshooting

Server not showing in Client

API errors

Test the server manually

Development

Links

Context API MCP Server

Features

Installation

1. Get your API Key

2. Configure Your Client

MCP Client configuration

Usage Examples

Search Relevant Posts

Get All User Posts

Check Credits

Tool Reference

search_relevant_posts

search_relevant_posts

get_all_user_posts

check_credits

Environment Variables

Troubleshooting

Server not showing in Client

API errors

Test the server manually

Development

Links