Semantic API MCP Server

1# Semantic API MCP Server
2 
3<!-- mcp-name: io.github.peter-j-thompson/semanticapi -->
4 
5An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that lets Claude, ChatGPT, and other LLM agents search and discover APIs using natural language via [Semantic API](https://semanticapi.dev). Ask for any API capability in plain English and get back endpoint details, parameters, auth info, and code snippets.
6 
7## Install
8 
9```bash
10pip install semanticapi-mcp
11```
12 
13Or run directly with uvx:
14 
15```bash
16uvx semanticapi-mcp
17```
18 
19## Configuration
20 
21### Get an API Key
22 
23Sign up at [semanticapi.dev](https://semanticapi.dev) to get your API key.
24 
25### Environment Variables
26 
27| Variable | Required | Default | Description |
28|----------|----------|---------|-------------|
29| `SEMANTIC_API_KEY` | Yes | — | Your Semantic API key |
30| `SEMANTIC_API_URL` | No | `https://semanticapi.dev` | API base URL override |
31 
32### Claude Desktop
33 
34Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
35 
36```json
37{
38  "mcpServers": {
39    "semanticapi": {
40      "command": "uvx",
41      "args": ["semanticapi-mcp"],
42      "env": {
43        "SEMANTIC_API_KEY": "your-api-key-here"
44      }
45    }
46  }
47}
48```
49 
50Or if installed with pip:
51 
52```json
53{
54  "mcpServers": {
55    "semanticapi": {
56      "command": "semanticapi-mcp",
57      "env": {
58        "SEMANTIC_API_KEY": "your-api-key-here"
59      }
60    }
61  }
62}
63```
64 
65## Tools
66 
67### `semantic_query`
68 
69Search for an API capability using natural language.
70 
71**Inputs:**
72- `query` (string, required) — What you want to do, e.g. "send an email with Gmail"
73- `auto_discover` (boolean, optional, default: true) — Auto-discover new APIs if needed
74 
75**Example:** "Find me an API to convert currencies in real-time"
76 
77### `semantic_discover`
78 
79Deep discovery of a specific provider/API by name and intent.
80 
81**Inputs:**
82- `provider_name` (string, required) — API provider name, e.g. "stripe", "twilio"
83- `user_intent` (string, optional) — What you want to do with this API
84 
85**Example:** Discover Stripe's capabilities for "process a refund"
86 
87### `semantic_discover_url`
88 
89Analyze any API from its documentation URL.
90 
91**Inputs:**
92- `url` (string, required) — URL of the API documentation
93- `user_intent` (string, optional) — What you want to do with this API
94 
95**Example:** Analyze `https://docs.example.com/api` to generate a provider config
96 
97## Related
98 
99- **[Semantic API](https://semanticapi.dev)** — The hosted API service
100- **[semanticapi-engine](https://github.com/peter-j-thompson/semanticapi-engine)** — Open source engine (AGPL-3.0)
101- **[semantic-api-skill](https://github.com/peter-j-thompson/semantic-api-skill)** — Agent framework skill package
102- **[CLI Tool](https://github.com/peter-j-thompson/semanticapi-cli)** — Command-line interface (`pip install semanticapi-cli`)
103 
104<!-- mcp-name: io.github.peter-j-thompson/semanticapi -->
105 
106## License
107 
108MIT
109