Multi-MCPs

Multi-MCPs is a server that aggregates multiple third-party APIs and exposes them as unified MCP tools. It lets you access weather, maps, news, GitHub, Notion, Trello, Spotify, Twilio, Unsplash, and CoinGecko through a single MCP endpoint, simplifying integration and consistency across services.

How to use

You run the MCP server locally and connect your MCP client to the stdio channel. Start the server, then from your client you can invoke the available tools such as weather queries, place searches, news lookups, repository information, and more through their unified MCP endpoints. Use the provided credentials to access each external service; if credentials are missing, tool calls will fail with a clear error.

How to install

Prerequisites: Node.js and npm must be installed on your machine.

Install dependencies for the project.

npm i

Additional sections

Build the project before running the MCP server.

npm run build

Run the MCP server in stdio mode using the final runtime command.

npx @modelcontextprotocol/inspector build/index.js

Configuration and credentials

Credentials for external services can be supplied via environment variables or a JSON config file at config/api-configs.json. Environment variables take precedence over file values.

Example configuration (values are placeholders you should replace with your actual keys):

{
  "OPENWEATHER_API_KEY": "...",
  "GOOGLE_API_KEY": "...",
  "NEWS_API_KEY": "...",
  "GITHUB_TOKEN": "...",
  "NOTION_TOKEN": "...",
  "TRELLO_KEY": "...",
  "TRELLO_TOKEN": "...",
  "SPOTIFY_CLIENT_ID": "...",
  "SPOTIFY_CLIENT_SECRET": "...",
  "TWILIO_ACCOUNT_SID": "...",
  "TWILIO_AUTH_TOKEN": "...",
  "UNSPLASH_ACCESS_KEY": "..."
}

You can also point to a custom config file by exporting the path to MUTI_MCPS_CONFIG.

export MUTI_MCPS_CONFIG=/abs/path/to/api-configs.json

Available tools

get_current_weather

Fetches current weather data for a location using the OpenWeather integration.

get_weather_forecast

Retrieves weather forecast data for a location.

get_weather_alerts

Gets weather alerts for specified regions.

search_places

Searches for places using Google Maps/Places data.

get_directions

Obtains directions between two points.

geocode_address

Converts addresses to geographic coordinates.

get_top_headlines

Fetches top news headlines from NewsAPI.

search_news

Searches news articles by keywords.

get_sources

Lists available news sources.

search_repositories

Searches GitHub repositories by criteria.

get_repository_info

Retrieves details for a specific GitHub repository.

create_issue

Creates a GitHub issue in a repository.

list_commits

Lists commits for a repository.

query_database

Queries a Notion database.

create_page

Creates a Notion page.

update_page

Updates a Notion page.

search_pages

Searches Notion pages.

get_boards

Fetches Trello boards.

create_card

Creates a Trello card.

update_card

Updates a Trello card.

get_board_cards

Lists cards on a Trello board.

search_tracks

Searches Spotify tracks.

get_track_info

Gets details for a Spotify track.

create_playlist

Creates a Spotify playlist.

add_tracks_to_playlist

Adds tracks to a Spotify playlist.

send_sms

Sends an SMS via Twilio.

make_call

Initiates a call via Twilio.

get_message_history

Retrieves Twilio message history.

search_photos

Searches Unsplash photos.

get_random_photo

Fetches a random Unsplash photo.

get_photo_details

Gets details for an Unsplash photo.

get_coin_price

Fetches current price for a CoinGecko coin.

get_trending_coins

Retrieves trending coins on CoinGecko.

get_market_data

Gets market data for cryptocurrencies.