AI agents can create, execute, and save API requests as organized collections within a project.
Also known as gudlab/gud-api, gud-api, @gudlab/gud-api-mcp
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- 200
- Latest version
- 0.1.3
- Last commit
- Sep 19, 2026
- License
- —
What is Gud API MCP?
Gud API is an MCP server. AI agents can create, execute, and save API requests as organized collections within a project.
Summary generated from the project's README
About Gud API MCP server
Managing and testing API requests directly through an AI agent is what this server enables. It allows developers to use AI clients to build, execute, and organize REST and GraphQL requests into structured collections within a project. By connecting the server via npx, an agent can interact with the Gud API ecosystem to automate testing and documentation workflows.
Users can handle various HTTP methods including GET, POST, PUT, and DELETE, along with complex body types like JSON, GraphQL, and multipart form-data for file uploads. The server supports authentication methods such as Bearer Tokens, Basic Auth, and API Keys. It also manages environments and variables using a double curly brace syntax to resolve values in URLs, headers, and bodies.
This tool is particularly useful for those who want to move away from external tools like Postman. It provides features like automatic cookie management, request history for the last 100 entries, and the ability to import existing Postman v2.x, Thunder Client, or OpenAPI collections. While the editor extension is proprietary, this MCP server is public and designed to work with the local project directory.
What you can do with it
- 1Automate API testing workflowsAn AI agent can create and run specific HTTP requests to verify endpoint behavior.
- 2Organize API documentation into collectionsDevelopers can instruct an AI to group related requests into nested folders for better project organization.
- 3Migrate existing API collectionsYou can ask an AI to import your current Postman or OpenAPI specifications into the Gud API environment.
Written from the project's README. Every use case is checked against a quote from it.
How to install Gud API MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Gud API MCP in Claude Code
$ claude mcp add gud-api -- npx -y @gudlab/gud-api-mcpInstall Gud API MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"gud-api": {
"command": "npx",
"args": [
"-y",
"@gudlab/gud-api-mcp"
]
}
}
}Install Gud API MCP in VS Code
.vscode/mcp.json
{
"servers": {
"gud-api": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gudlab/gud-api-mcp"
]
}
}
}Install Gud API MCP in VS Code CLI
$ code --add-mcp '{"name":"gud-api","type":"stdio","command":"npx","args":["-y","@gudlab/gud-api-mcp"]}'Install Gud API MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"gud-api": {
"command": "npx",
"args": [
"-y",
"@gudlab/gud-api-mcp"
]
}
}
}Install Gud API MCP in Codex
$ codex mcp add gud-api -- npx -y @gudlab/gud-api-mcpInstall Gud API MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.gud-api] command = "npx" args = ["-y", "@gudlab/gud-api-mcp"]
Install Gud API MCP in Gemini CLI
$ gemini mcp add -s user gud-api npx -- -y @gudlab/gud-api-mcpInstall Gud API MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"gud-api": {
"command": "npx",
"args": [
"-y",
"@gudlab/gud-api-mcp"
]
}
}
}Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablegudlab/gud-api is public and reachablegithub.com/gudlab/gud-api ↗Pass
- Package names this repository as its source@gudlab/gud-api-mcp names gudlab/gud-api as sourcenpmjs.com/package/@gudlab/gud-api-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-09-19github.com/gudlab/gud-api ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @gudlab/gud-api-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubGud 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
Environments & Variables
{{variable}}syntax in URLs, headers, and body — resolved automatically on send- Collection-level variables imported from Postman (e.g.
{{base_url}}) - User-defined environments with key-value editor and enable/disable toggles
- Environment selector in the toolbar — switch between environments instantly
- Variable resolution order: environment overrides collection variables
Editor Integration
- Activity bar icon for quick access
- Matches your VS Code theme automatically (light, dark, high contrast)
- Works without a workspace open (stores in VS Code global storage)
- Keyboard shortcut: Enter to send request
Getting Started
- Install the extension from Open VSX or the VS Code Marketplace
- Click the Gud API icon in the activity bar
- Enter a URL and press Send
- Click Save to add the request to a collection
To import an existing collection, click Import in the sidebar and select a Postman, Thunder Client, or OpenAPI JSON file.
MCP for AI agents
Agents can create, run, and save requests as real Gud API collections via @gudlab/gud-api-mcp:
{
"mcpServers": {
"gud-api": {
"command": "npx",
"args": ["-y", "@gudlab/gud-api-mcp", "--project", "."]
}
}
}
Source and tools: gudlab/gud-api-mcp. Guide: gudapi.gudlab.org/guide/ai-agents.
Free vs Pro
Gud API is free to use with no limits on requests, collections, or folders. Team / cloud sync is the Pro upsell.
| Feature | Free | Pro |
|---|---|---|
| Unlimited requests | Yes | Yes |
| Collections & folders | Yes | Yes |
| Import (Postman, Thunder Client, OpenAPI) | Yes | Yes |
| Auth (Bearer, Basic, API Key) | Yes | Yes |
| GraphQL support | Yes | Yes |
| Multipart form-data & file upload | Yes | Yes |
| Code generation (cURL, fetch, Python, axios) | Yes | Yes |
| Request history | Yes | Yes |
| Cookie management | Yes | Yes |
| Response search & format toggle | Yes | Yes |
| Collection variables | Yes | Yes |
| Environments | 1 | Unlimited |
| Team sync | - | Yes |
| Cloud collections | - | Yes |
Pro: $4/month or $29 lifetime.
Support
Gud API is free with no limits. If it saves you time, consider supporting development:
Feedback & Issues
Report bugs or request features at github.com/gudlab/gud-api/issues.
License
Proprietary. See LICENSE. The editor UI is not open source. The MCP server has its own license in gudlab/gud-api-mcp.
Gud API MCP questions
How do I add Gud API MCP to Claude Code?
Run claude mcp add gud-api -- npx -y @gudlab/gud-api-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Gud API MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can AI agents do with this MCP server?
Agents can create, run, and save API requests as real Gud API collections.
Can I import existing collections from other tools?
Yes, you can import Postman v2.x collections, Thunder Client collections, and OpenAPI 3.x or Swagger 2.0 specs.
Is there a cost to use Gud API?
Gud API is free to use with no limits on requests, collections, or folders, while Pro features like team sync and unlimited environments are available for a fee.