# gud-api-mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/gudlab/gud-api  
**GitHub Stars:** 2  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gud-api-mcp

## Description
AI agents create, run, and save API requests as Gud API collections in your project.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "gud-api-mcp": {
    "url": "https://open-vsx.org/extension/gudlab/gud-api"
  }
}
```

## Documentation & README

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

Available on [OpenVSX](https://open-vsx.org/extension/gudlab/gud-api) and the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=gudlab.gud-api). Learn more at [gudlab.org/gudapi](https://gudlab.org/gudapi.html).

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

1. Install the extension from OpenVSX or the VS Code Marketplace
2. Click the **Gud API** icon in the activity bar
3. Enter a URL and press **Send**
4. 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.

## Free vs Pro

Gud API is free to use with no limits on requests, collections, or folders.

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

- [Buy Me a Coffee](https://buymeacoffee.com/timchosen)
- [PayPal](https://paypal.me/timchosen)

## Feedback & Issues

Report bugs or request features at [github.com/gudlab/gud-api/issues](https://github.com/gudlab/gud-api/issues).

## License

Proprietary. See the LICENSE file included with this extension for details.