Data Omnifeeds MCP

🚀 Recall Data Omnifeeds Server

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

🚀 Quick Start

Integrating 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:

   {
     "command": "run",
     "args": ["node", "dist/src/index.js"]
   }
   

4. Restart Claude to complete the integration.

Installing Dependencies

Run the following command to install the required dependencies:

npm install @types/node typescript ts-node

✨ Features

Twitter Integration

• Retrieve user profiles and tweets.
• Search for tweets and user profiles.
• Access trending topics.
• Full write permissions (tweet, like, retweet, follow).
• Support for direct messages.
• Grok chat integration.

Substack Integration

• Get publication information.
• View recent articles.
• Access article comments.
• Search for articles.
• Support for custom domains and subdomains.

CoinGecko Integration

• Get current token prices.
• Get contract addresses and chain information.
• Search for tokens.
• Get popular tokens.
• Support for free and Pro API access.

💻 Usage Examples

Basic Usage

Get Twitter Profile

Call the twitter-get-profile tool:

await tools.call({
  tool: "twitter-get-profile",
  args: {
    username: "username"
  }
});

Search Tweets

Call the twitter-search-tweets tool:

await tools.call({
  tool: "twitter-search-tweets",
  args: {
    query: "search term"
  }
});

Get Substack Articles

Call the substack-get-recent-posts tool:

await tools.call({
  tool: "substack-get-recent-posts",
  args: {
    substackId: "substack ID"
  }
});

Get CoinGecko Price

Call the coingecko-get-price tool:

await tools.call({
  tool: "coingecko-get-price",
  args: {
    tokenId: "token ID"
  }
});

📚 Documentation

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 the Project

npm run build

Running Tests

npm test

📄 License

ISC

🤝 Contribution Guidelines

1. Fork the repository.
2. Create a 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.