YCombinator Tweet Search MCP Server

This Model Context Protocol (MCP) server provides a tool for searching through YCombinator tweets using natural language queries.

Setup

1. Environment Configuration

   Create a .env file in the project root with:

   MCP_API_KEY=your_api_key_here

2. Installation

   Install dependencies:

   npm install

3. Building the Server

   Compile TypeScript:

   npm run build

4. Running the Server

   Start the server:

   npm start

   For development with stdio transport:

   npm run dev:stdio

Using the Tweet Search Tool

The server provides a search_tweets tool that accepts natural language queries to search through YCombinator tweets.

Tool Parameters

{
  "name": "search_tweets",
  "params": {
    "query": "your search query here"
  }
}

Example Queries

• "startup funding"

• "AI projects"

• "YC companies"

• "founder advice"

• "demo day"

Response Format

The tool returns a formatted list of matching tweets with:

• Date

• Tweet type (RETWEETED, QUOTED, REPLIED_TO) if applicable

• Tweet content

Integration with LLM Systems

This server implements the Model Context Protocol, making it compatible with:

• Anthropic Claude

• OpenAI models

• Custom MCP clients

How It Works

1. Tweets are fetched from the configured GitHub URL

2. Each tweet is scored against the query using a relevance algorithm

3. Top 10 most relevant results are returned

4. Results include date, context (if it's a retweet, etc.), and content

Development

To modify the search algorithm, look at the calculateRelevanceScore function in src/client.ts.

To change the tweet formatting, modify the handleSearchTweets function in src/tools/tweets.ts.