3Min API — MCP Server Guide

Technical documentation for the 3Min API MCP server. This guide covers available tools, authentication, setup instructions, and usage examples.

1. Server Description

3Min API is an API relay service designed for small businesses without backend development capability. It uses a Schema-as-Data design where API schemas are stored as structured data, eliminating the need for per-customer database setup.

The MCP server enables AI assistants like Claude to manage API endpoints, send test requests, search logs, view analytics, and manage collaborators — all through natural language conversation.

2. Features

Available Tools

  • help — Get guided help and service reference for any topic
  • endpoints — Create, configure, update, and deploy API endpoints
  • api_call — Send HTTP requests (POST, GET, PUT, DELETE) through the API Gateway
  • logs — Search logs by text, date range, or record ID with archived payload support
  • stats — View monthly usage analytics with daily breakdowns per endpoint
  • collaborators — Manage collaboration keys, permissions, and invitations
  • subscription — Check plan details, usage counts, and billing information
  • archives — List and download archived data files (CLI only)

Use Cases

  • Quickly set up and test API endpoints without writing any code
  • Monitor API usage and investigate issues through logs and statistics
  • Manage team access by creating collaboration keys and sending invitations

3. Setup Instructions

MCP Server URL:

https://3minapi.com/api/mcp

Claude.ai / Claude Desktop

  1. Open Settings → Connectors
  2. Click "Add Custom Connector"
  3. Enter the MCP server URL shown above
  4. Complete OAuth sign-in when prompted

No API key needed — authentication is handled automatically via OAuth.

Claude Code / CLI

  1. Generate an MCP API key from your dashboard (Settings → MCP Integration)
  2. Add the server configuration to your MCP client:
{
  "mcpServers": {
    "3minapi": {
      "url": "https://3minapi.com/api/mcp",
      "headers": {
        "x-api-key": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Replace YOUR_MCP_API_KEY with the key generated in step 1.

4. Authentication

The MCP server supports OAuth 2.1 with PKCE (S256) for browser-based clients and API key authentication for CLI tools.

OAuth 2.1 (Claude.ai / Desktop)

Fully automated — users simply sign in through their browser. The server implements:

  • RFC 8414 — Authorization Server Metadata Discovery
  • RFC 7591 — Dynamic Client Registration
  • RFC 9728 — Protected Resource Metadata
  • PKCE (S256) — Proof Key for Code Exchange

API Key (CLI)

Pass the MCP API key via the x-api-key header or as an environment variable in your MCP client configuration.

5. Usage Examples

Example 1: Create a Sandbox API Endpoint

"Using 3minapi, I want to receive online orders. I need the customer's name, order amount, and email address. The name and email should be searchable."

Action: Claude calls endpoints(action: "create", endpoint_name: "orders", field_definitions: [...])

Result: A new endpoint is created with sandbox field definitions. The response includes the endpoint ID, a default collaboration key with sandbox/production API keys, and the endpoint URL for receiving API calls.

Example 2: Test with a Sandbox API Call

"Send a test order from John Doe for $150 to the endpoint I just created"

Action: Claude calls api_call(endpoint_id: "...", environment: "sandbox", method: "POST", body: [fields]), then logs(endpoint_id: "...", environment: "sandbox") to verify the result.

Result: The API Gateway processes the request asynchronously (202 Accepted). Claude then retrieves the log entry showing the record was created successfully with all field values stored.

Example 3: Search Sandbox Logs

"Show me all orders from the last week that mention John"

Action: Claude calls logs(endpoint_id: "...", environment: "sandbox", search_text: "john", start_date: "...", end_date: "...")

Result: Returns matching log entries with record IDs, HTTP methods, status codes, timestamps, and payload data. Results are paginated (10 per page) with total count.

6. Privacy Policy

Our full privacy policy is available at:

https://3minapi.com/privacy

7. Support

For questions, issues, or feedback:

Email: contact@3minapi.com