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

Related

License

MIT

Metadata

Release files for semanticapi-mcp 0.1.1

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.1.1
File Size Uploaded Provenance Actions
semanticapi_mcp-0.1.1.tar.gz 3.3 kB Without provenance Details for semanticapi_mcp-0.1.1.tar.gz

Built distribution (wheel)

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

Total release size: 7.4 kB

Release files / semanticapi_mcp-0.1.1.tar.gz

Download URL semanticapi_mcp-0.1.1.tar.gz
Size 3.3 kB
Tags Source
SHA-256 checksum
How to use checksums
677adc656b5cad745b2056fb3d931b4bad8fb505d32bc64ec9c6192d19c89b65
BLAKE2b-256 checksum
How to use checksums
d00d755c511bbfe1235ecbecdcfd3ef6b29a4a5e48183240b6de0e1177a144e6
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.1.1-py3-none-any.whl

Download URL semanticapi_mcp-0.1.1-py3-none-any.whl
Size 4.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ebcfb3b95adaba861f2034c01d2867bf5d6d5da6f612d5ded3d16e3d16f2344b
BLAKE2b-256 checksum
How to use checksums
b5b94a836bac8502bc2d97d3bf808fa61389ddab6519f70e683fe4fcd112c163
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.1.1

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