# API operation

> API operation is a freemium MCP server for developer tools. Looks up a single operation in a public OpenAPI document by URL and plain-language query. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://spec.bestsmartgoods.com/docs
- **Repository:** https://github.com/ladanyin/agentlane
- **MCP Registry name:** io.github.ladanyin/api-operation
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http api-operation https://spec.bestsmartgoods.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://spec.bestsmartgoods.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "api-operation": {
      "url": "https://spec.bestsmartgoods.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "api-operation": {
      "type": "http",
      "url": "https://spec.bestsmartgoods.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "api-operation": {
      "serverUrl": "https://spec.bestsmartgoods.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "api-operation": {
      "type": "http",
      "url": "https://spec.bestsmartgoods.com/mcp"
    }
  }
}
```

## Tools

- `lookup_operation`: Reads one operation from a public OpenAPI document matched by a plain-language query.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/api-operation
