Skip to main content

Semantic API MCP Server

An MCP (Model Context Protocol) server that lets Claude, ChatGPT, and other LLM agents search and discover APIs using natural language via Semantic API. Ask for any API capability in plain English and get back endpoint details, parameters, auth info, and code snippets.

Install

pip install semanticapi-mcp

Or run directly with uvx:

uvx semanticapi-mcp

Configuration

Get an API Key

Sign up at semanticapi.dev to get your API key.

Environment Variables

Variable Required Default Description
SEMANTIC_API_KEY Yes — Your Semantic API key
SEMANTIC_API_URL No https://semanticapi.dev API base URL override

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "semanticapi": {
      "command": "uvx",
      "args": ["semanticapi-mcp"],
      "env": {
        "SEMANTIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Or if installed with pip:

{
  "mcpServers": {
    "semanticapi": {
      "command": "semanticapi-mcp",
      "env": {
        "SEMANTIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tools

semantic_query

Search for an API capability using natural language.

Inputs:

  • query (string, required) — What you want to do, e.g. "send an email with Gmail"
  • auto_discover (boolean, optional, default: true) — Auto-discover new APIs if needed

Example: "Find me an API to convert currencies in real-time"

semantic_discover

Deep discovery of a specific provider/API by name and intent.

Inputs:

  • provider_name (string, required) — API provider name, e.g. "stripe", "twilio"
  • user_intent (string, optional) — What you want to do with this API

Example: Discover Stripe's capabilities for "process a refund"

semantic_discover_url

Analyze any API from its documentation URL.

Inputs:

  • url (string, required) — URL of the API documentation
  • user_intent (string, optional) — What you want to do with this API

Example: Analyze https://docs.example.com/api to generate a provider config

semantic_catalog

Browse and search the provider catalog. No API key required.

Inputs:

  • page (integer, optional, default: 1) — Page number
  • auth_type (string, optional) — Filter by auth type: "bearer", "apikey", "oauth2", "none"
  • category (string, optional) — Filter by category: "payments", "ai", "communication", etc.
  • search (string, optional) — Search by name or description
  • free_only (boolean, optional) — Only show providers with a free tier

Example output:

📦 Stripe (stripe)
   Online payment processing platform
   Auth: bearer | Free tier: no | Capabilities: 12

📦 Open-Meteo (open-meteo)
   Free weather API, no key required
   Auth: none | Free tier: yes | Capabilities: 5

Page 1/4 (38 total providers)

semantic_provider_detail

Get full details for a specific provider including all capabilities. No API key required.

Inputs:

  • provider_id (string, required) — Provider identifier, e.g. "stripe", "open-meteo"

Example output:

📦 Stripe (stripe)
   Online payment processing platform
   Base URL: https://api.stripe.com
   Auth: bearer
   Signup: https://dashboard.stripe.com/register
   Free tier: no

   Capabilities:
   ├─ create-charge: Create a new charge
   │  POST /v1/charges
   └─ list-customers: List all customers
      GET /v1/customers

semantic_catalog_stats

Get public statistics about the catalog. No API key required.

Example output:

📊 Semantic API Catalog Stats
   Total Providers: 38
   Total Capabilities: 245
   Categories: 12

semantic_categories

List all available provider categories. No API key required.

Example output:

📂 Provider Categories

   • payments (8 providers)
   • ai (6 providers)
   • communication (5 providers)
   • weather (3 providers)

License

MIT

Metadata

Release files for semanticapi-mcp 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for semanticapi-mcp 0.2.0
File Size Uploaded Provenance Actions
semanticapi_mcp-0.2.0.tar.gz 5.3 kB Without provenance Details for semanticapi_mcp-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for semanticapi-mcp 0.2.0
File Interpreter ABI Platform Actions
semanticapi_mcp-0.2.0-py3-none-any.whl Python 3 none any Details for semanticapi_mcp-0.2.0-py3-none-any.whl

Total release size: 11.7 kB

Release files / semanticapi_mcp-0.2.0.tar.gz

Download URL semanticapi_mcp-0.2.0.tar.gz
Size 5.3 kB
Tags Source
SHA-256 checksum
How to use checksums
cf39ff5a3c3feb592ec2668757ad40ccba88d8504dc729a77ee2475c3aced9e6
BLAKE2b-256 checksum
How to use checksums
ea8f610559e019463a8536ee6e1fc3c0c7e433308bba3853c01072f4452d62ab
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release files / semanticapi_mcp-0.2.0-py3-none-any.whl

Download URL semanticapi_mcp-0.2.0-py3-none-any.whl
Size 6.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
47e2f04740c77a0623d890024f71d2a7c182e6aef2766be7b5e7440915108335
BLAKE2b-256 checksum
How to use checksums
bf1629a8b83f1af6d59f38a78b344e740a72569c6d0258c35dbcbeb9d687559b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Security for semanticapi-mcp 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page