API operation
Looks up a single operation in a public OpenAPI document by URL and plain-language query
- Pricing
- Freemium
- Platforms
- API
- Runs
- Remotely
- Version
- 1.0.0
- Listing updated
- 3 days ago
About API operation
API operation is a freemium MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
Point it at the URL of an OpenAPI document and describe what you want to do, such as the Petstore example "create a pet". The tool returns the one matching operation: its HTTP method, path and required fields. That keeps a whole specification out of the model's context when only one endpoint matters.
It is one of several small remote servers published by the same developer, each on its own subdomain. This one lives at spec.bestsmartgoods.com/mcp and exposes a single tool, lookup_operation, with a matching REST endpoint at /v1/specs/operation.
Usage is metered in credits. Five calls a day are free from one network address, and after that each call costs 0.04 credit with an API key sent in the X-API-Key header. New keys include 20 credits.
Install
Run in a terminal
claude mcp add --transport http api-operation https://spec.bestsmartgoods.com/mcpAdd to Settings → Connectors → Add custom connector
https://spec.bestsmartgoods.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"api-operation": {
"url": "https://spec.bestsmartgoods.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"api-operation": {
"type": "http",
"url": "https://spec.bestsmartgoods.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"api-operation": {
"serverUrl": "https://spec.bestsmartgoods.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"api-operation": {
"type": "http",
"url": "https://spec.bestsmartgoods.com/mcp"
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- lookup_operation
- Reads one operation from a public OpenAPI document matched by a plain-language query.
What it does
- Single-operation lookup
- Returns one operation from a spec instead of the whole document.
- Natural-language query
- Match an endpoint by describing the task, such as creating a pet.
- Method, path and required fields
- The result covers the details needed to build a request.
- REST twin
- The same lookup is available as a POST to /v1/specs/operation.
- Daily free calls
- Five free calls a day from one network address before credits apply.
Good for
- Find the endpoint to call for a task in a third-party API
- Check which fields a create request requires
- Give a coding agent a small slice of a large spec
- Build a request from a public OpenAPI URL
Pricing
Freemium
5 free calls/day, then 0.04 credit per call; new keys include 20 credits
Prices change. Check spec.bestsmartgoods.com before you buy.
API operation FAQ
What does it return?
One operation from the OpenAPI document: method, path and required fields.
Is it free?
Five calls a day are free from one network address, then 0.04 credit per call.
How do I authenticate past the free calls?
Send an API key in the X-API-Key header; new keys include 20 credits.
Can I use it without MCP?
Yes, POST a JSON body with the spec URL and query to /v1/specs/operation.
Is API operation free?
API operation has a free plan, with paid plans for more usage or features.
How do I add API operation to Claude Code?
Run this command in your terminal: claude mcp add --transport http api-operation https://spec.bestsmartgoods.com/mcp
What are the best alternatives to API operation?
The closest alternatives to API operation are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to API operation

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools