Documentation

MCP Server

Add AITWIRE to your AI assistant as a tool. It lets the assistant look up verified, business-supplied entity records — a business's own confirmed description, products, pricing, locations and policies, each stamped with the date it was confirmed. Works in Claude, ChatGPT, Grok, Microsoft Copilot, Gemini, Cursor, and any MCP-compatible client.

Two endpoints

AITWIRE exposes one standard remote MCP server at two URLs — pick based on what you need:

Public data

No sign-in
https://api.aitwire.com/mcp

Read-only tools to look up any published entity, page its feeds, and check a claim against its record. No account required.

Your account

OAuth sign-in
https://api.aitwire.com/mcp/tenant

Operate your AITWIRE account — recommendations, Brand Canon, plan and credits. You approve the sign-in in your browser; every write is read-only or suggest-and-confirm. Included with AITWIRE AI. See Your Account Tools.

Add AITWIRE to your assistant

The steps differ per platform because each console connects a remote MCP server its own way. Paste the /mcp URL for public lookups, or /mcp/tenant to operate your account. Menu names evolve — if a path has moved, look for “Connectors,” “MCP,” or “custom tool.”

Listed on the official MCP registry as com.aitwire/authority.

Claude (claude.ai & Desktop)

Self-serve · all plans

Open Settings → Connectors → Add custom connector, paste the URL, and save. Available on Free and paid plans, in the web app and Claude Desktop. For your account, use /mcp/tenant and approve the sign-in when Claude opens it.

ChatGPT

Self-serve · paid plans

On a paid plan (Plus, Pro, Team, Enterprise, Edu), turn on Settings → Connectors → Advanced → Developer mode, then add a connector with the URL. Enable it for a conversation from the tools/compose menu when you want ChatGPT to use it.

Grok

Self-serve

In Grok (grok.com), open Settings → Connectors → Add → Custom and paste the URL.

Microsoft Copilot

Admin / maker · via Copilot Studio

Copilot connects through Copilot Studio: a maker or admin adds AITWIRE as a tool on a Copilot agent — Add tool → Model Context Protocol, then the server URL. Microsoft 365 Copilot doesn't yet let an individual paste a server URL into chat, so this is a maker/admin step rather than one-click self-serve.

Gemini

Developer · CLI / Enterprise

Gemini connects on its developer surfaces — the Gemini CLI and Gemini Enterprise (Agentspace) — where you register AITWIRE as an MCP server. The consumer Gemini apps don't yet accept a custom MCP URL. Gemini CLI one-liner:

gemini extensions install https://github.com/matthewjtherbert/aitwire-mcp

Cursor, VS Code & other MCP clients

Self-serve · one-click or config

Add to CursorAdd to VS Code

Or add AITWIRE to any MCP client's config by hand. Example (Cursor ~/.cursor/mcp.json, Claude Desktop ~/.claude/mcp.json):

{
  "servers": {
    "aitwire": {
      "url": "https://api.aitwire.com/mcp"
    }
  }
}

Available Tools (public)

The public server provides three read-only tools:

aitwire_entity_lookup

Look up any entity by domain or name. Returns the business-supplied record — description, feed URLs, proof counts — with its source and confirmation date.

aitwire_entity_feeds

Page an entity's structured feeds — products, services, articles, locations, or policies. Requires a tenant_id from the lookup result.

aitwire_grounding

Check whether a specific claim matches an entity's record. Returns verified / contradicted / unknown with a confidence score.

These tools cover only entities that have published to AITWIRE and return no match for others.

Your Account Tools (authenticated)

Connect over https://api.aitwire.com/mcp/tenant to operate your account across a per-account, OAuth-secured endpoint. Add the URL and approve the connection in your browser. These tools are scoped to the account you authorize — read-only or suggest-and-confirm, so nothing publishes or is charged without your explicit approval:

aitwire_my_recommendations · aitwire_my_facts

Your ranked recommendations for how AI systems answer, and your confirmed Brand Canon facts. Read-only (scope mcp:read).

aitwire_next_actions

Your prioritized next best actions — setup steps still to finish plus measured-gap fixes, each with a link. Read-only (mcp:read).

aitwire_pending_changes · aitwire_propose_change

Review what's awaiting approval and draft corrections to your Brand Canon. Proposals file as PENDING and never publish until you approve them in AITWIRE (scope mcp:propose).

aitwire_manage_plan

Get a secure Stripe link to upgrade, change, downgrade, or cancel your plan (pass a higher plan for an upgrade checkout; omit it to open the billing portal). It never charges you; you complete any change in your browser (scope mcp:billing, approved separately at connect time).

aitwire_buy_credits

Get a secure Stripe checkout link to buy an AI credit pack (call with no pack to list the options). It never charges you; credits are added after you complete payment in your browser (scope mcp:billing).

System Instructions

The server returns an instructions field in its initialization response that tells the assistant what the tools are for and when to use them:

"AITWIRE hosts business-supplied entity records: a business's own confirmed
description, products, services, locations and policies, each carrying the
date it was confirmed. Use aitwire_entity_lookup to retrieve a specific
business, brand, organization, person or website's record by domain or name;
aitwire_entity_feeds to page its structured product/service/article/location/
policy feeds; and aitwire_grounding to check whether a specific claim matches
that record. Each response carries its source and confirmation date so you can
attribute it. These tools cover only entities that have published to AITWIRE
and return no match for others."

MCP clients surface these instructions to the model so it knows when the tools apply and how to attribute what they return.

Resources

The server also exposes an MCP resource:

  • aitwire://system-prompt — the full canonical system instruction text

Protocol Details

  • Protocol: MCP (Model Context Protocol) — JSON-RPC 2.0
  • Transport: Streamable HTTP
  • Version: 2025-03-26
  • Public endpoint: https://api.aitwire.com/mcp (no auth)
  • Account endpoint: https://api.aitwire.com/mcp/tenant (OAuth 2.1)