🚀 Gotrasoft Postman

Supercharge your AI Agents with Postman-like API Testing Capabilities.

Bridging the gap between AI and real-world APIs, Gotrasoft Postman is a robust Model Context Protocol (MCP) server that empowers AI models to execute complex HTTP requests with the precision and flexibility of a developer using Postman.

Whether you're debugging endpoints, testing integrations, or scraping data, this tool gives your AI the power to interact with the web seamlessly.

✨ Key Features

• 🔥 Comprehensive Method Support: Full support for GET, POST, PUT, DELETE, PATCH, HEAD, and OPTIONS.
• 🛡️ Flexible Authentication: Handle any security layer with ease:
  • No Auth: For public endpoints.
  • Basic Auth: Traditional username/password.
  • Bearer Token: Modern JWT and OAuth flows.
  • API Key: Custom headers or query parameters.
• 📦 Advanced Body Handling:
  • JSON: Auto-serialization for modern APIs.
  • Form Data: Perfect for file uploads and complex submissions (multipart/form-data).
  • URL Encoded: Standard web form optimization (application/x-www-form-urlencoded).
  • Raw/Text: For anything else.
• 🧠 Smart Validation: Built-in intelligence to detect common errors (like missing bodies in POST requests) and provide self-correction hints to the AI.

📦 Installation

Get started instantly. No complex setup required.

Global Installation (Recommended)

Make it available everywhere on your system:

npm install -g gotrasoft-postman

Run via npx

Run it on-demand without installing:

npx -y gotrasoft-postman

🛠️ Setup & Configuration

Integrate Gotrasoft Postman into your favorite AI tools like Claude Desktop or VS Code (via MCP extensions).

🧩 VS Code Setup

Add this to your MCP extension configuration (e.g., cascade or generic MCP settings):

{
  "mcpServers": {
    "postman": {
      "command": "npx",
      "args": [
        "-y",
        "gotrasoft-postman"
      ]
    }
  }
}

Tip: If installed globally, just use gotrasoft-postman as the command.

🤖 Claude Desktop Setup

Modify your config file to give Claude superpowers:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "postman": {
      "command": "npx",
      "args": [
        "-y",
        "gotrasoft-postman"
      ]
    }
  }
}

💡 Usage Examples

The server exposes a single, versatile tool: make_request.

1. Simple GET Request

Fetch data with query parameters.

{
  "name": "make_request",
  "arguments": {
    "method": "GET",
    "url": "https://api.example.com/users",
    "params": {
      "page": 1,
      "limit": 10
    }
  }
}

2. Complex POST with Auth

Send JSON data to a protected endpoint.

{
  "name": "make_request",
  "arguments": {
    "method": "POST",
    "url": "https://api.example.com/orders",
    "headers": {
      "Accept": "application/json"
    },
    "opts": {
        "auth": {
            "type": "bearer",
            "config": {
                "token": "sk_live_123456"
            }
        },
        "body": {
            "type": "json",
            "content": {
                "product_id": "prod_999",
                "quantity": 5
            }
        }
    }
  }
}

🔗 Explore the Ecosystem

Build a complete development toolkit for your AI Agents with our other MCP servers:

🐬 Gotrasoft MySQL

Safe, read-only database exploration. Give your AI the ability to inspect schemas, list tables, and run safe SELECT queries on your MySQL/MariaDB databases without risk. Perfect for generating context-aware code and debugging data issues.

📄 License

MIT © I Komang Gede Yuliana

Built with ❤️ by Gotrasoft for the AI native future.