TaylorChen/muti-mcps

Multi-MCPs

Multi-MCPs is a Model Context Protocol (MCP) server that aggregates multiple third-party APIs and exposes them as unified MCP tools. It ships with out-of-the-box support for the top 10 commonly used external services: OpenWeather, Google Maps/Places, NewsAPI, GitHub, Notion, Trello, Spotify, Twilio, Unsplash, and CoinGecko.

Install

npm i

Run

Build:

npm run build

Run as an MCP server (stdio):

npx @modelcontextprotocol/inspector build/index.js

Configuration

Provide credentials via environment variables or config/api-configs.json. Environment variables take precedence over file values.

Example config/api-configs.json:

{
  "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 with:

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

Available Tools (selection)

• Weather: get_current_weather, get_weather_forecast, get_weather_alerts
• Maps: search_places, get_directions, geocode_address
• News: get_top_headlines, search_news, get_sources
• GitHub: search_repositories, get_repository_info, create_issue, list_commits
• Notion: query_database, create_page, update_page, search_pages
• Trello: get_boards, create_card, update_card, get_board_cards
• Spotify: search_tracks, get_track_info, create_playlist, add_tracks_to_playlist
• Twilio: send_sms, make_call, get_message_history
• Unsplash: search_photos, get_random_photo, get_photo_details
• CoinGecko: get_coin_price, get_trending_coins, get_market_data

Note: Tools are listed even if credentials are missing; calls will fail with a clear error if the required credentials are not configured.

License

This project is licensed under the MIT License. See LICENSE for details.