Recall Data Omnifeeds

A Model Context Protocol (MCP) server that provides access to various data feeds including Twitter, Substack, and CoinGecko. This server enables AI models to interact with and analyze data from multiple sources through a unified interface.

Features

- Twitter Integration
- Get user profiles and tweets
- Search tweets and profiles
- Access trending topics
- Full write access (tweet, like, retweet, follow)
- Direct messaging support
- Grok chat integration

- Substack Integration
- Get publication information
- Retrieve recent posts
- Access post comments
- Search posts
- Support for both custom domains and subdomains

- CoinGecko Integration
- Get current token prices
- Retrieve contract addresses and chains
- Search for tokens
- Get trending tokens
- Support for both free and Pro API access

Integrate with Claude

1. Install and build the server:

   npm install

   npm run build

   

2. In Claude, go to Settings -> Developer -> Add MCP endpoint

3. Add the following configuration:

   {

     "mcpServers": {

       "recall-data-omnifeeds": {

         "command": "node",

         "args": ["path to omnifeeds build they just created"],

         "env": {

           "PORT": "3008",

           "TWITTER_USERNAME": "xx",

           "TWITTER_PASSWORD": "xxx",

           "TWITTER_EMAIL": "xxx",

           "COINGECKO_API_KEY": "xxx" (optional)

         }

       }

   }

   

4. Restart Claude

5. Verify the integration:
- Look for a number next to a hammer icon in the bottom right of the prompt input
- Test the integration by asking:

     has anyone mentioned a cool coin lately on this list https://x.com/i/lists/1879866762147303588?

     

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/recall-data-omnifeeds.git

   cd recall-data-omnifeeds

   

2. Install dependencies:

   npm install

   

3. Create a .env file with your API credentials:

   # Twitter credentials (if needed)

   TWITTER_USERNAME=your_twitter_username

   TWITTER_PASSWORD=your_twitter_password

   TWITTER_EMAIL=your_twitter_email

# CoinGecko credentials (optional)

   COINGECKO_API_KEY=your_api_key  # Optional: enables Pro API features

   

4. Build the project:

   npm run build

   

5. Start the server:

   npm start

   

Usage

The server implements the Model Context Protocol (MCP) and can be used with any MCP-compatible client. Here are some example invocations:

Twitter Examples

// Get a user's profile
const result = await server.invoke("twitter-get-profile", {
  username: "example_user"
});
// Get recent tweets

const result = await server.invoke("twitter-get-tweets", {

  username: "example_user",

  count: 10

});
// Search tweets

const result = await server.invoke("twitter-search-tweets", {

  query: "example search",

  count: 20

});

Substack Examples

// Get publication info
const result = await server.invoke("substack-get-publication-info", {
  substackId: "example.substack.com"
});
// Get recent posts

const result = await server.invoke("substack-get-recent-posts", {

  substackId: "example.substack.com",

  limit: 10

});
// Search posts

const result = await server.invoke("substack-search-posts", {

  substackId: "example.substack.com",

  searchTerm: "example search",

  limit: 10

});

CoinGecko Examples

// Get token price
const result = await server.invoke("coingecko-get-price", {
  tokenId: "bitcoin",
  currency: "usd"
});
// Get contract addresses

const result = await server.invoke("coingecko-get-contracts", {

  tokenId: "usd-coin"

});
// Search tokens

const result = await server.invoke("coingecko-search", {

  query: "ethereum",

  limit: 5

});
// Get trending tokens

const result = await server.invoke("coingecko-trending", {

  limit: 5

});

API Reference

Twitter Tools

| Tool Name | Description | Parameters |
|-----------|-------------|------------|
| twitter-get-profile | Get a user's profile information | username (required) |
| twitter-get-tweets | Get recent tweets from a user | username (required), count (optional, default: 10) |
| twitter-search-tweets | Search for tweets | query (required), count (optional, default: 20) |
| twitter-get-trends | Get trending topics | None |
| twitter-send-tweet | Send a tweet | text (required) |
| twitter-like-tweet | Like a tweet | tweetId (required) |
| twitter-retweet | Retweet a tweet | tweetId (required) |
| twitter-follow-user | Follow a user | username (required) |

Substack Tools

| Tool Name | Description | Parameters |
|-----------|-------------|------------|
| substack-get-publication-info | Get publication information | substackId (required) |
| substack-get-recent-posts | Get recent posts | substackId (required), limit (optional, default: 10) |
| substack-search-posts | Search posts | substackId (required), searchTerm (required), limit (optional, default: 10) |
| substack-get-comments | Get comments for a post | substackId (required), postId (required) |

CoinGecko Tools

| Tool Name | Description | Parameters |
|-----------|-------------|------------|
| coingecko-get-features | Get available CoinGecko API features | None |
| coingecko-get-price | Get the current price of a token | tokenId (required), currency (optional, default: "usd") |
| coingecko-get-contracts | Get contract addresses and chains for a token | tokenId (required) |
| coingecko-search | Search for tokens by query | query (required), limit (optional, default: 10) |
| coingecko-trending | Get trending tokens | limit (optional, default: 10) |

Development

Project Structure

recall-data-omnifeeds/
├── src/
│   ├── index.ts              # Main server entry point
│   ├── twitter-client.ts     # Twitter API client
│   ├── substack-client.ts    # Substack API client
│   ├── coingecko-client.ts   # CoinGecko API client
│   └── tools/               # MCP tool implementations
├── dist/                    # Compiled JavaScript files
├── package.json            # Project configuration
└── tsconfig.json          # TypeScript configuration

Building

npm run build

Running Tests

npm test

License

ISC

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request