# Openapi MCP

> Openapi MCP is an open-source MCP server for developer tools. Generate and verify signed requests for the Goldpopcon gold and silver trading API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/keumbang/goldpopcon-openapi-mcp
- **License:** MIT
- **MCP Registry name:** com.goldpopcon/openapi-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

Signing is where integrators get stuck with this Korean gold and silver trading API: the query_hash input differs by method (raw body for POST, a normalised query string for GET), and code copied from an Upbit example fails with 401. This server writes that procedure for you and can check a token locally.

It bundles the API specification, so an assistant can list endpoints with their permission scopes, idempotency and rate buckets, show request and response examples, and produce complete signed-request code in Python, JavaScript, Go or curl. A diagnostic tool takes an existing JWT and checks it in the same order the server does, to explain a 401. Secret keys are used only for local signing.

A live call_api tool is off by default. When enabled through an environment variable it is production-only, limited to GET and to five read operations such as prices and balances, so buying, selling and payouts can only be generated as code.

## Features

- **Endpoint reference:** list_endpoints and get_endpoint expose scopes, parameters, bodies and examples.
- **Signed request generator:** Produces working code in Python, JavaScript, Go or curl.
- **Local signing:** sign_request builds the JWT on your machine without sending the secret.
- **Signature verification:** verify_signature explains why a token gets a 401.
- **Read-only live calls:** Opt-in call_api is restricted to GET and a whitelist of lookup operations.

## Good for

- Write a client for the trading API
- Debug a 401 on a signed request
- Look up error codes and retry rules
- Poll prices and balances from an automation

## Install

### Claude Code (Terminal)

```sh
claude mcp add openapi-mcp --env GOLDPOPCON_SECRET_KEY='<GOLDPOPCON_SECRET_KEY>' -- npx -y @keumbang/goldpopcon-openapi-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@keumbang/goldpopcon-openapi-mcp"
      ],
      "env": {
        "GOLDPOPCON_SECRET_KEY": "<GOLDPOPCON_SECRET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@keumbang/goldpopcon-openapi-mcp"
      ],
      "env": {
        "GOLDPOPCON_SECRET_KEY": "<GOLDPOPCON_SECRET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "openapi-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@keumbang/goldpopcon-openapi-mcp"
      ],
      "env": {
        "GOLDPOPCON_SECRET_KEY": "<GOLDPOPCON_SECRET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@keumbang/goldpopcon-openapi-mcp"
      ],
      "env": {
        "GOLDPOPCON_SECRET_KEY": "<GOLDPOPCON_SECRET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@keumbang/goldpopcon-openapi-mcp"
      ],
      "env": {
        "GOLDPOPCON_SECRET_KEY": "<GOLDPOPCON_SECRET_KEY>"
      }
    }
  }
}
```

## Tools

- `list_endpoints`: Lists endpoints with permission scope, idempotency and rate bucket.
- `get_endpoint`: Details for one endpoint: parameters, body schema, examples, response codes.
- `list_error_codes`: Error code table with retry guidance per status.
- `signing_guide`: Explains the JWT signing procedure.
- `generate_signed_request`: Generates signed request code in python, javascript, go or curl.
- `sign_request`: Computes a JWT locally for debugging.
- `verify_signature`: Validates an existing JWT the way the server does.
- `call_api`: Optional read-only live call, enabled by environment variable.

## FAQ

### How do I get API keys?

Only in the Goldpopcon app, under its Open API menu; the sk_ secret is shown once.

### Can it place orders?

No. Live calls are read-only; buy, sell and payout endpoints only get generated code to run yourself.

### How do I enable call_api?

Set GOLDPOPCON_MCP_ALLOW_LIVE=true; keys can be passed as environment variables.

### What rate limits apply?

The README lists 600 per minute for quotes and 60 per minute for trades.

### Is Openapi MCP free?

Yes. Openapi MCP is open source, so you can use and self-host it for free.

### How do I add Openapi MCP to Claude Code?

Run this command in your terminal: claude mcp add openapi-mcp --env GOLDPOPCON_SECRET_KEY='<GOLDPOPCON_SECRET_KEY>' -- npx -y @keumbang/goldpopcon-openapi-mcp

### What are the best alternatives to Openapi MCP?

The closest alternatives to Openapi MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

---
Source: https://ai-powered.com/mcp/openapi-mcp
