MCP server

Let your coding agent call your APIs

gostman mcp gives Claude Code, Cursor and Codex the requests, environments and checks you already have. The server decides which hosts the agent reaches and which secrets it gets.

Works with
claude · gostman mcp
  1. Check that creating a user still returns 201

    send_requestUsers/Create user

    201 Created · 142 ms · 1 check passed

    Authorization: Bearer {{API_TOKEN}}

  2. Add a request that deletes the user

    save_requestUsers/Delete user

    Saved in Users

Install the gostman command, create a workspace and register it with your agent. Requests you already have are ready to use.

  1. Create a workspace

    Writes the workspace folder and the Agent Skill.

    gostman init --skill
  2. Register the server

    Cursor, Codex and other MCP clients take the same command.

    claude mcp add gostman -- gostman mcp --workspace /path/to/gostman

Setup guide

The same collection you use in the app, as tools.

  • Read your collection

    Saved requests and environments, with every credential masked.

    list_requestsget_request

  • Send and run

    One request or a whole folder, with its scripts and checks.

    send_requestrun_folder

  • Save requests

    New requests and checks land as YAML files you review in git diff.

    save_request

  • Import specs

    OpenAPI, Postman, Insomnia, Bruno, HAR or a curl command.

    import_requests

  • Mock and load test

    Serve saved examples on localhost, or send one request repeatedly.

    start_mockload_test

  • Requests as tools

    Tag a request and it becomes a tool of its own, its variables as parameters.

    --expose-tag

Every tool

Enforced by the server, not by instructions the agent is asked to follow.

  • Allowlisted hosts

    Only localhost, the hosts of your own requests and the ones you allow.

  • Secrets stay names

    The agent reads {{API_TOKEN}}, never the token, which is sent only where your own requests send it.

  • No silent overwrites

    A save is refused when the request changed since the agent read it, and a journal shows who saved what.

  • No files or commands

    Agent sessions never read local files, run commands or open a browser sign-in.

How the safety model works

go install github.com/kunalgoesbyken/gostman/cmd/gostman@latest
gostman init --skill

Use Gostman from a coding agent