doppelgangersai/context-mcp-server

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 mcp add context-api -- npx context-api-mcp

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

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

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

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

copilot

/mcp add

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

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

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

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

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

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

{
  "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

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.

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.

check_credits

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

Environment Variables

Troubleshooting

Server not showing in Client

1. Ensure you have Node.js 18+ installed
2. Check that CONTEXT_API_KEY is set correctly
3. 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:

1. Clone the repository
2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Run the server:

   node dist/index.js
   

Links

• Context API Documentation
• npm package