> For the complete documentation index, see [llms.txt](https://docs.edgetag.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgetag.io/mcp/tools/overview.md).

# Overview

EdgeTag MCP provides 22 tools that give your AI assistant direct access to your EdgeTag data. These tools cover everything from domain management and analytics to real-time debugging and user data queries.

### How tools work

When you ask your AI assistant a question about your EdgeTag data, it automatically selects the right tool to answer it. You don't need to know tool names or parameters - just ask in plain language.

For example:

* "How many purchases did we get today?" -> uses `domainAnalytics`
* "Show me errors for my Shopify store" -> uses `domainErrors`
* "What's our Meta EMQ score?" -> uses `metaEMQ`
* "Look up a user by email" -> uses `domainIDGraph`

### Getting started

Every session starts the same way:

1. `**me**` - Verify your identity and see which teams you belong to
2. `**domains**` - List all your domains (tags) with their channels and IDs

The `domains` tool returns the IDs you need for all other tools: `domainId`, `teamId`, `channelId`, and `providerId`.

### Tool categories

#### Account & Domain Management

| Tool                                  | Description                                    |
| ------------------------------------- | ---------------------------------------------- |
| [me](/mcp/tools/me.md)                | Get your user info and team memberships        |
| [domains](/mcp/tools/domains.md)      | List all domains with their channels           |
| [domainAdd](/mcp/tools/domain-add.md) | Add a new domain to your team                  |
| [dns](/mcp/tools/dns.md)              | Verify DNS records for a domain                |
| [channel](/mcp/tools/channel.md)      | Get channel configuration and consent settings |

#### Analytics

| Tool                                                               | Description                                        |
| ------------------------------------------------------------------ | -------------------------------------------------- |
| [domainAnalytics](/mcp/tools/domain-analytics.md)                  | Traffic overview by status, event name, or channel |
| [domainAnalyticsProvider](/mcp/tools/domain-analytics-provider.md) | Event breakdown for a specific channel             |
| [domainAnalyticsEvent](/mcp/tools/domain-analytics-event.md)       | Channel breakdown for a specific event             |
| [domainErrors](/mcp/tools/domain-errors.md)                        | Error breakdown by channel and category            |
| [metaEMQ](/mcp/tools/meta-emq.md)                                  | Facebook Event Match Quality score                 |

#### User Data

| Tool                                           | Description                        |
| ---------------------------------------------- | ---------------------------------- |
| [domainIDGraph](/mcp/tools/domain-id-graph.md) | Query the per-domain user database |

#### Edge Lake

Requires the [DataNexus Shopify app](https://apps.shopify.com/blotout-datanexus) to be installed.

| Tool                                                                | Description                                  |
| ------------------------------------------------------------------- | -------------------------------------------- |
| [edgeLakeQuery](/mcp/tools/edge-lake-query.md)                      | Run SQL queries against your event data lake |
| [edgeLakeCodeQuery](/mcp/tools/edge-lake-code-query.md)             | Run JavaScript programs for complex analysis |
| [edgeLakeTrafficAnalysis](/mcp/tools/edge-lake-traffic-analysis.md) | Browser, OS, device, and country breakdown   |
| [edgeLakeBotScore](/mcp/tools/edge-lake-bot-score.md)               | Bot detection and scoring analysis           |
| [edgeLakeAttackAnalysis](/mcp/tools/edge-lake-attack-analysis.md)   | WAF attack classification                    |

#### ConsentIQ

Requires the [ConsentIQ Shopify app](https://apps.shopify.com/blotout-consentiq) to be installed.

| Tool                                                      | Description                          |
| --------------------------------------------------------- | ------------------------------------ |
| [consentIQOverview](/mcp/tools/consentiq-overview.md)     | Consent analytics overview by region |
| [consentIQCategories](/mcp/tools/consentiq-categories.md) | Consent breakdown by category        |

#### Real-Time Debugging

| Tool                                            | Description                      |
| ----------------------------------------------- | -------------------------------- |
| [loggerStart](/mcp/tools/logger-start.md)       | Start streaming live server logs |
| [loggerMessages](/mcp/tools/logger-messages.md) | Read buffered log messages       |
| [loggerStop](/mcp/tools/logger-stop.md)         | Stop the logger session          |

#### Token Management

| Tool                                      | Description                                |
| ----------------------------------------- | ------------------------------------------ |
| [revokeToken](/mcp/tools/revoke-token.md) | Revoke your auth token and re-authenticate |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.edgetag.io/mcp/tools/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
