Gud Api Mcp

io.github.gudlabPublished by GitHub account gudlabv0.1.3Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

Lets an AI assistant create, run, and save HTTP API requests as Gud API collections inside a project.

What you can do
The Gud API MCP server connects an assistant to the Gud API client so it can build API requests, execute them, and store them as real collections in the project. The companion editor extension supports REST and GraphQL requests, environments and variables, response inspection, code generation, history, cookies, and imports from Postman, Thunder Client, and OpenAPI specs. The MCP server itself is published as the npm package @gudlab/gud-api-mcp and runs locally over stdio.
When to use it
Useful when you want an assistant to exercise or document an HTTP API and keep the resulting requests as organized, reusable collections in your project rather than ad-hoc commands. It fits teams already using the Gud API editor extension who want agent-driven request creation and execution.
Requirements
Runs as a local process over stdio, started with npx from the npm package @gudlab/gud-api-mcp, typically with a project path argument. Node.js and network access to the target APIs are needed. No authentication, environment variables, or headers are declared for the MCP server.
Before you install
Requests the assistant runs can send data to third-party APIs and may change or delete remote data depending on the endpoints called. Requests may carry credentials such as bearer tokens, basic auth, or API keys, and cookies captured from responses are stored and re-sent to matching domains. The editor extension is proprietary; only the MCP server source is public. Team sync and cloud collections are paid Pro features.

Installation

In SourceWeft

  1. Open Gud Api Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

[Open VSX] [VS Marketplace]

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

  1. Install the extension from Open VSX 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.

MCP for AI agents

Agents can create, run, and save requests as real Gud API collections via @gudlab/gud-api-mcp:

json
{  "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.

FeatureFreePro
Unlimited requestsYesYes
Collections & foldersYesYes
Import (Postman, Thunder Client, OpenAPI)YesYes
Auth (Bearer, Basic, API Key)YesYes
GraphQL supportYesYes
Multipart form-data & file uploadYesYes
Code generation (cURL, fetch, Python, axios)YesYes
Request historyYesYes
Cookie managementYesYes
Response search & format toggleYesYes
Collection variablesYesYes
Environments1Unlimited
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.

Source: README.md at commit e9eef7f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.3LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.