What is External Mcp

external-mcp is a Model Context Protocol (MCP) server that allows AI models and agents to interact with and search data from multiple curated sources, such as Twitter, Substack, and CoinGecko, through a unified interface.

Use cases

Use cases for external-mcp include monitoring social media trends, analyzing content from Substack publications, and tracking cryptocurrency prices and trends, enabling users to gain insights from diverse data feeds.

How to use

To use external-mcp, install and build the server using npm, configure it with your credentials for Twitter and CoinGecko, and integrate it with Claude by adding the MCP endpoint in the settings. After restarting Claude, verify the integration by testing it with specific queries.

Key features

Key features of external-mcp include Twitter integration for accessing user profiles, tweets, and trending topics; Substack integration for retrieving publication information and recent posts; and CoinGecko integration for accessing current token prices and trending tokens.

Where to use

external-mcp can be used in various fields such as social media analysis, content aggregation, and cryptocurrency tracking, making it suitable for businesses and developers looking to leverage data from multiple sources.

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:

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

Substack Tools

CoinGecko Tools

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