# TagMango MCP

> TagMango MCP is a Model Context Protocol (MCP) server that gives AI coding agents deep, structured knowledge of every TagMango API endpoint, authentication flow, and integration pattern.

## What this server does

The TagMango MCP server exposes four tools that AI agents use to discover and query the TagMango API registry:

- **list_modules** — returns all API modules with descriptions and keywords
- **get_module_endpoints** — lists endpoints in a module (method, path, auth type, context)
- **get_endpoint_detail** — returns full schemas, parameters, integration notes, and usage examples for 1–5 endpoints
- **submit_feedback** — agents report missing endpoints, schema issues, or submit a session summary

## MCP endpoint

```
https://mcp.tagmango.com/mcp
```

Supports Streamable HTTP transport (POST, GET, DELETE).

## How to connect

### Cursor
Add to `~/.cursor/mcp.json`:
```json
{
  "mcpServers": {
    "tagmango-builders": {
      "url": "https://mcp.tagmango.com/mcp"
    }
  }
}
```

### Claude Code
```bash
claude mcp add --scope user --transport http tagmango-builders https://mcp.tagmango.com/mcp
```

### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "tagmango-builders": {
      "url": "https://mcp.tagmango.com/mcp"
    }
  }
}
```

### Lovable
In your project, go to **Connectors** → search for **Custom MCP** → enter a name, paste `https://mcp.tagmango.com/mcp` as the server URL, choose **No Authentication**, and click **Add & Authorize**.

## Authentication overview

TagMango has two API surfaces:

- **External API** — server-to-server, Bearer API key + `x-whitelabel-host` header
- **Core API** — user-facing SSO. TagMango passes a refresh token to your app URL; exchange it for a short-lived access token via `POST /get-access-token`

Full authentication guides are available as MCP resources at:
- `tagmango://guides/auth-external`
- `tagmango://guides/auth-core-api`

## Documentation

Full setup guide: https://mcp.tagmango.com/get-started