# DodoTag MCP: Install guide

Public connector for Claude and ChatGPT.

## Connector URL

```
https://mcp.app.dodotag.com/mcp
```

Health check: `https://mcp.app.dodotag.com/healthz`

## Authentication

- OAuth 2.1 (Authorization Code + PKCE)
- Sign in with your DodoTag account on first connect
- No API keys in the chat client
- JWT tokens stay server-side; MCP uses opaque tokens

OAuth metadata:

- `https://mcp.app.dodotag.com/.well-known/oauth-protected-resource/mcp`
- `https://mcp.app.dodotag.com/.well-known/oauth-authorization-server`

## Quick setup prompt

Paste in Claude or ChatGPT (includes connector URL and install guide):

```
Add and connect DodoTag MCP to my assistant.

Connector URL (remote HTTP): https://mcp.app.dodotag.com/mcp
Install guide: https://www.dodotag.com/skills/dodotag-mcp/install.md

Auth: OAuth 2.1 with DodoTag login (no API keys in the client).
Primary tool: find_video_ideas (Dodo score, Hype score, performance vs channel).

Once connected, use find_video_ideas to find YouTube outliers in my niche.
```

Italian:

```
Aggiungi e connetti DodoTag MCP al mio assistente.

Connector URL (HTTP remoto): https://mcp.app.dodotag.com/mcp
Guida install: https://www.dodotag.com/skills/dodotag-mcp/install.md

Auth: OAuth 2.1 con login DodoTag (nessuna API key nel client).
Tool primario: find_video_ideas (Dodo score, Hype score, performance vs canale).

Quando sei connesso, usa find_video_ideas per trovare outlier YouTube nella mia nicchia.
```

## Claude CLI

```bash
claude mcp add --transport http dodotag https://mcp.app.dodotag.com/mcp
```

## ChatGPT

1. Enable Developer Mode
2. Add custom MCP connector
3. URL: `https://mcp.app.dodotag.com/mcp`
4. Complete OAuth with DodoTag

## Primary tool

Always start with **`find_video_ideas`** for YouTube idea search with Dodo score, Hype score and performance vs channel.

Do not use `youtube_search` instead of `find_video_ideas`. It is a single-query follow-up without scoring.

## Tool categories (~34 read-only)

| Category | Examples |
| --- | --- |
| Find Ideas | `find_video_ideas` |
| YouTube | `video_details`, `channel_info`, `get_video_transcript`, … |
| Competitors | `competitor_top_videos`, `list_competitors`, … |
| Discovery | `discovery_feed`, `discovery_gaps`, `discovery_weekly`, … |
| Scripts | `list_script_templates`, `get_generated_script`, … |
| Account | `me`, `dashboard`, `subscription_status`, … |

## Security

- Read-only toward DodoTag APIs (no publish, no persistent user writes)
- Scope: `dodotag:read`
- Rate limits on OAuth and HTTP endpoints

## Links

- Marketing page (IT): https://www.dodotag.com/it/mcp
- Marketing page (EN): https://www.dodotag.com/en/mcp
- DodoTag app: https://app.dodotag.com
- Support: info@dodotag.com

## Troubleshooting

- **401 / 422**: expired OAuth session. Reconnect the connector.
- **429**: rate limit. Retry later.
- Production OAuth requires HTTPS issuer (no insecure issuer override)