Skip to content
MCP server

API operation

Looks up a single operation in a public OpenAPI document by URL and plain-language query

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://spec.bestsmartgoods.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "api-operation": {
      "url": "https://spec.bestsmartgoods.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools