integrations-mcp

Built by an autnomous agent over about a day

A comprehensive MCP (Model Context Protocol) server that exposes 390+ tools across 66 providers, giving AI assistants direct access to popular SaaS platforms, public APIs, and utility services.

Quick Start

# Install dependencies
pip install -e .

# Run the MCP server
python server.py

Configure provider-specific environment variables (see table below) for authenticated services. Providers with missing credentials are skipped gracefully at startup.

Architecture

server.py                  → FastMCP entry point
providers/__init__.py      → Lazy provider registry (all providers loaded on demand)
providers/<name>.py        → Individual provider modules, each exporting a register(mcp) function

Each provider is imported lazily so a missing optional dependency only disables that one provider — the rest of the server continues to work.

Provider Table

Provider	Module	Tools	API / Service	Auth Required	Env Vars
Advice Slip	advice.py	2	Advice Slip API	No	—
Airtable	airtable_provider.py	7	Airtable (pyairtable)	Yes	AIRTABLE_API_KEY
Amplitude	amplitude_provider.py	8	Amplitude Analytics API	Yes	AMPLITUDE_API_KEY, AMPLITUDE_SECRET_KEY
arXiv	arxiv_provider.py	3	arXiv API	No	—
Asana	asana_provider.py	9	Asana REST API v1	Yes	ASANA_ACCESS_TOKEN
Calendly	calendly_provider.py	9	Calendly API v2	Yes	CALENDLY_ACCESS_TOKEN
Cloudflare	cloudflare_provider.py	7	Cloudflare SDK	Yes	CLOUDFLARE_API_TOKEN
CoinGecko	coingecko_provider.py	3	CoinGecko API v3	No	—
REST Countries	countries.py	6	restcountries.com v3.1	No	—
Currency Exchange	currency.py	4	Frankfurter API (ECB)	No	—
Datadog	datadog_provider.py	6	Datadog API	Yes	DD_API_KEY, DD_APP_KEY
Datetime Utilities	datetime_utils.py	4	Python stdlib (zoneinfo)	No	—
Dictionary	dictionary.py	5	Free Dictionary API + Datamuse	No	—
Dog Images	dogs.py	4	Dog CEO API	No	—
Exchange Rates	exchange_rates.py	3	Frankfurter API (ECB)	No	—
Figma	figma_provider.py	8	Figma REST API v1	Yes	FIGMA_ACCESS_TOKEN
GitHub	github_provider.py	16	GitHub REST API v3	Yes	GITHUB_TOKEN
GitHub Public	github_public.py	3	GitHub REST API (unauth)	No	—
GitHub Search	github_search.py	4	GitHub REST API (unauth)	No	—
Google Calendar	google_calendar.py	7	Google Calendar API v3	Yes	GOOGLE_CALENDAR_CREDENTIALS_JSON
Google Sheets	google_sheets_provider.py	8	Google Sheets API v4	Yes	GOOGLE_SERVICE_ACCOUNT_JSON or GOOGLE_SHEETS_API_KEY
Hacker News	hackernews_provider.py	8	HN Firebase + Algolia API	No	—
HubSpot	hubspot_provider.py	11	HubSpot CRM API v3	Yes	HUBSPOT_ACCESS_TOKEN
HuggingFace	huggingface_provider.py	6	HuggingFace Hub SDK	Yes	HUGGINGFACE_API_KEY
Intercom	intercom_provider.py	10	Intercom REST API v2.11	Yes	INTERCOM_ACCESS_TOKEN
IP Geolocation	ipgeo.py	2	ip-api.com	No	—
ISS Tracker	iss.py	3	Open Notify API	No	—
Jira	jira_provider.py	7	Jira REST API (atlassian-python-api)	Yes	JIRA_URL, JIRA_USER, JIRA_API_TOKEN
Jokes	jokes.py	2	JokeAPI v2	No	—
Linear	linear_provider.py	13	Linear GraphQL API	Yes	LINEAR_API_KEY
Meals	meals.py	3	TheMealDB API	No	—
Mixpanel	mixpanel_provider.py	10	Mixpanel APIs	Yes	MIXPANEL_SERVICE_ACCOUNT_USERNAME, MIXPANEL_SERVICE_ACCOUNT_SECRET, MIXPANEL_PROJECT_TOKEN
Monday.com	monday_provider.py	8	Monday.com GraphQL API v2	Yes	MONDAY_API_KEY
NASA	nasa.py	5	NASA APIs (APOD, NeoWs, Mars)	Optional	NASA_API_KEY (falls back to DEMO_KEY)
Notion	notion_provider.py	9	Notion API v1	Yes	NOTION_API_KEY
Number Facts	numberfacts.py	3	numbersapi.com	No	—
Numbers	numbers.py	3	numbersapi.com	No	—
Numbers API	numbers_api.py	3	numbersapi.com	No	—
Okta	okta_provider.py	10	Okta Management API	Yes	OKTA_DOMAIN, OKTA_API_TOKEN
Open Library	openlibrary_provider.py	3	Open Library API	No	—
PagerDuty	pagerduty_provider.py	9	PagerDuty REST API v2	Yes	PAGERDUTY_API_KEY
Poetry	poetry.py	3	PoetryDB	No	—
Postmark	postmark_provider.py	8	Postmark API	Yes	POSTMARK_SERVER_TOKEN
QR Code	qrcode.py	3	goqr.me API	No	—
Quotes	quotes.py	3	Quotable API + ZenQuotes	No	—
Random User	random_user.py	2	RandomUser.me API	No	—
Random User (alt)	randomuser.py	2	RandomUser.me API	No	—
Resend	resend_provider.py	7	Resend REST API	Yes	RESEND_API_KEY
RSS/Atom Feeds	rss_provider.py	3	Any RSS/Atom feed (feedparser)	No	—
AWS S3	s3_provider.py	8	AWS S3 (boto3)	Yes	AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION
Salesforce	salesforce_provider.py	8	Salesforce REST API v60.0	Yes	SALESFORCE_CLIENT_ID, SALESFORCE_CLIENT_SECRET, SALESFORCE_USERNAME, SALESFORCE_PASSWORD
SendGrid	sendgrid_provider.py	9	SendGrid Web API v3	Yes	SENDGRID_API_KEY
Sentry	sentry_provider.py	6	Sentry Web API	Yes	SENTRY_AUTH_TOKEN
Shopify	shopify_provider.py	11	Shopify Admin REST API	Yes	SHOPIFY_SHOP, SHOPIFY_ACCESS_TOKEN
Slack	slack_provider.py	10	Slack Web API	Yes	SLACK_BOT_TOKEN
Snowflake	snowflake_provider.py	8	Snowflake SQL REST API	Yes	SNOWFLAKE_ACCOUNT, SNOWFLAKE_USER, SNOWFLAKE_PASSWORD
Stripe	stripe_provider.py	11	Stripe REST API v1	Yes	STRIPE_SECRET_KEY
Supabase	supabase_provider.py	11	Supabase Management API + PostgREST	Yes	SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, SUPABASE_ACCESS_TOKEN
Timezone	timezone.py	5	WorldTimeAPI	No	—
Trivia	trivia.py	2	Open Trivia DB	No	—
Twilio	twilio_provider.py	8	Twilio REST API	Yes	TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN
Vercel	vercel_provider.py	7	Vercel REST API	Yes	VERCEL_TOKEN
Weather	weather.py	3	Open-Meteo + Nominatim	No	—
Weather (Open-Meteo)	weather_openmeteo.py	2	Open-Meteo API	No	—
Wikipedia	wikipedia_provider.py	4	Wikimedia REST API	No	—
Zendesk	zendesk_provider.py	9	Zendesk REST API v2	Yes	ZENDESK_SUBDOMAIN, ZENDESK_EMAIL, ZENDESK_API_TOKEN

Total: 66 providers · 390+ tools · 34 authenticated · 32 free/public

Detailed Tool Reference

See providers/PROVIDERS.md for a full reference of every tool with parameters, descriptions, and example outputs.

Adding a New Provider

1. Create providers/your_provider.py with a register(mcp) function.
2. Use @mcp.tool() to decorate each tool function.
3. Add ("providers.your_provider", "register") to the _PROVIDERS list in providers/__init__.py.
4. Add any new dependencies to pyproject.toml.

def register(mcp):
    @mcp.tool()
    def your_tool_name(param: str) -> dict:
        """Description of what this tool does."""
        # implementation
        return {"result": "..."}

License

See repository for license details.