Gud API MCP server
io.github.gudlab/gud-api-mcp·v0.1.3·2 starsAI agents create, run, and save API requests as Gud API collections in your project.
2 stars42 downloads/wk
Reviews
Write oneNobody has reviewed Gud API yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Gud API tools (8, 5 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
create_collectionwrite actionCreate a new collection in the project (.gud-api/collections). Returns its id.
delete_requestwrite actionDelete a saved request from a collection by id or name.
get_active_environmentReturn the active environment's variables. Secret-looking values (token/key/secret/password/\u2026) are masked \u2014 send_request still resolves the real values server-side.
get_collectionGet the full contents of one collection: folders, requests (with method/url/headers/body), and variables. Example response bodies are summarized.
list_collectionsList all Gud API collections in the project's .gud-api folder, with request counts and folder names.
send_requestwrite actionExecute a request and return status, timing, headers, and a (truncated) body. Resolves {{variables}} from the active environment and the request's collection. Optionally capture the response as a saved example.
upsert_environmentwrite actionCreate or update an environment (a named set of variables, e.g. base_url and tokens). Matched by name. Optionally set it active for subsequent send_request calls.
upsert_requestwrite actionCreate or update a request inside a collection (matched by name). The collection is created if it doesn't exist. Optionally nest it under a folder path.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 7 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
How Gud API compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 91/100
- higher than 85% of 48,273 servers
- Tools
- 8
- the typical server has 7
- Tools that change things
- 63%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 75% of 28,534 servers
- Downloads a week
- 42
- more than 35% of 11,915 servers with a package
What its tools let an agent do: 3 read · 1 create · 2 change · 1 delete · 1 send or post
Install Gud API in Claude Code, Cursor or VS Code
Runs npx -y @gudlab/gud-api-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add gud-api-mcp -- npx -y @gudlab/gud-api-mcp
What the publisher says
From the Gud API repository's README, as published. We do not edit it. Read it on GitHub
Gud API
A lightweight, full-featured API client built into your editor. Test REST and GraphQL APIs, organize requests into collections, manage environments, and generate code snippets — without switching to Postman or another external tool.
Install from Open VSX or the VS Code Marketplace. Site: gudapi.gudlab.org.
Source
The editor extension is proprietary. This repository is the public home for product docs and issues. It does not contain the VS Code / Open VSX extension source.
If you followed the GitHub link from the Marketplace or Open VSX, you are in the right place for bugs and feature requests. There is nothing here to clone for the UI.
The companion MCP server is public: @gudlab/gud-api-mcp, source in gudlab/gud-api-mcp. Docs: gudapi.gudlab.org/guide/ai-agents.
Features
Request Builder
- All HTTP methods: GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD
- Query params editor with bidirectional URL sync and enable/disable toggles
- Headers editor with dynamic key-value rows
- Multiple body types: JSON, Form URL Encoded, Multipart Form Data, GraphQL, plain text
- File uploads via multipart form-data with native file picker
- Auth: Bearer Token, Basic Auth, API Key (header or query param)
GraphQL
- Dedicated GraphQL editor with separate Query and Variables panes
- Auto-sets method to POST and Content-Type to application/json
- Variables parsed as JSON and sent alongside the query
Response Viewer
- Status code, response time, size, and format detection (JSON/HTML/XML)
- Pretty / Raw / Preview toggle — preview renders HTML in a sandboxed iframe
- Search — find text in the response body with match count and navigation
- Cookies tab — view Set-Cookie headers from the response
- Copy button for body or headers
Code Generation
- Generate code from any request with one click
- Languages: cURL, JavaScript (fetch), Python (requests), Node.js (axios)
- Copy to clipboard
Request History
- Every request is auto-saved to history (last 100 entries)
- View history in the sidebar with method, URL, status, and timestamp
- Click any entry to reload it into the request builder
- Persists across VS Code sessions
Cookie Management
- Cookies from responses are automatically captured and stored
- Cookies are auto-sent on subsequent requests to matching domains
- Cookie Manager to view, enable/disable, and delete cookies by domain
- In-memory storage — cookies reset when VS Code restarts
Collections
- Save and organize requests into collections and folders
- Click to load any saved request back into the builder
- Right-click to rename, delete, or create new folders
- Supports deeply nested folder structures
Import
- Postman v2.x collections (including nested folders, headers, body, and collection variables)
- Thunder Client collections
- OpenAPI 3.x / Swagger 2.0 specs (paths become requests, tags become folders)
- Import via sidebar button or command palette
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Gud API: common questions
- Is Gud API MCP server safe?
- Yes, by our scan: it is graded A (91/100). Read the Gud API safety report
- How do I install Gud API?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Gud API need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Gud API maintained?
- The last commit was 44 days ago (2026-09-19). The latest release is v0.1.3.
- How does Gud API compare with other MCP servers?
- safety score 91/100 (higher than 85% of 48,273 servers); tools 8 (the typical server has 7); tools that change things 63% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.