How do I use gaip-broker?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@gaip-broker can you check if this agent card is conformant? https://agent.example/.well-known/agent-card.json" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

gaip-broker

by tjcgraham-rgb

Overview Schema Source Related Servers Discussions Admin

Python

Remote

GAIP

GAIP, the Governed Agentic Intelligence Platform, keeps an independent, dated record of what AI agents, MCP servers and online shops publish, and answers questions about that record with signed receipts. Free, read-only, no key; facts at a stated time, never an assessment.

First call: gaip_check with a url on https://www.gaipagents.com/mcp. This one runs as-is; then use the URL of the agent, MCP server or API you care about:

curl -s https://www.gaipagents.com/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gaip_check","arguments":{"url":"https://mcp.deepwiki.com/mcp"}}}'

Without MCP: GET https://www.gaipagents.com/v1/free/conformance/check?url=<url>.

The map: every question GAIP answers, grouped by who asks, with its tool and HTTP route: https://www.gaipagents.com/v1/free/map. Every completed answer carries a continuity handle; send it back and the answer is bound to your own history with GAIP.

One line to connect

Where	One line
Any MCP client	`https://www.gaipagents.com/mcp` (streamable HTTP, no sign-in)
Claude Code	`claude mcp add --transport http gaip https://www.gaipagents.com/mcp`, or the plugin (MCP server and skill): `/plugin install gaip --marketplace tjcgraham-rgb/gaip-agents`
Claude Desktop / claude.ai	Customize > Connectors > Add custom connector, URL `https://www.gaipagents.com/mcp`, no sign-in
Agent Skills (Claude Code, Cursor, Codex and others)	`npx skills add tjcgraham-rgb/gaip-agents` (installs `skills/gaip/SKILL.md`)
Cursor, VS Code	the buttons below, or `{ "mcpServers": { "gaip": { "url": "https://www.gaipagents.com/mcp" } } }`
Gemini CLI	`gemini extensions install https://github.com/tjcgraham-rgb/gaip-agents`
OpenAI Agents SDK	`HostedMCPTool(tool_config={"type": "mcp", "server_label": "gaip", "server_url": "https://www.gaipagents.com/mcp", "require_approval": "never"})`
Vercel AI SDK	`await createMCPClient({ transport: { type: 'http', url: 'https://www.gaipagents.com/mcp' } })` (from `@ai-sdk/mcp`)
LangChain	`pip install langchain-gaip`, then `from langchain_gaip import get_tools`
CrewAI	`Agent(..., mcps=["https://www.gaipagents.com/mcp"])`
A2A (1.0 and 0.3.0)	agent card `https://www.gaipagents.com/.well-known/agent-card.json`; plain text works
x402	nothing to set up: GAIP is free and never answers with HTTP 402 (`https://www.gaipagents.com/.well-known/x402`)
Windsurf	`~/.codeium/windsurf/mcp_config.json`: `{ "mcpServers": { "gaip": { "serverUrl": "https://www.gaipagents.com/mcp" } } }`
Cline	`{ "mcpServers": { "gaip": { "type": "streamableHttp", "url": "https://www.gaipagents.com/mcp" } } }` (see `llms-install.md`)
Everything else, with copy-paste code	https://www.gaipagents.com/docs/quickstart

Add to Cursor Install in VS Code

Related MCP server: turva-mcp

In CI: two GitHub Actions

GAIP Watch fails your build when an MCP server or agent your agent depends on changed its tools, schemas, sign-in or prices, with dated receipts (watch/):

- uses: tjcgraham-rgb/gaip-agents/watch@main
  with:
    urls: https://mcp.example.com/mcp

GAIP Agents check runs gaip_check on your own agent card, MCP server or OpenAPI document on every push:

- uses: tjcgraham-rgb/gaip-agents@v1
  with:
    agent-url: https://your-agent.example/.well-known/agent-card.json
    fail-on-error: "true"

Outputs: verdict (READY, FIXES_NEEDED, UNREACHABLE or NOT_CHECKED), receipt-id, error-count, warning-count. Providers can show their own dated record with the badge https://www.gaipagents.com/v1/free/watch/badge.svg?url=<your endpoint>.

In this repository

Path	What it is
`registry/`	The Official MCP Registry records: `gaip-broker.json` (GAIP itself) and one record per specialist agent
`listing-kit.json`	The sentence, the first call, the map's rows, endpoints and example calls for directories (also served at `/v1/free/discovery/listing-kit`)
`skills/gaip/SKILL.md`	GAIP as an Agent Skill (agentskills.io format; also served at `/.well-known/agent-skills/gaip/SKILL.md`)
`.claude-plugin/`	Claude Code plugin and marketplace manifests: the skill plus the remote MCP server
`.cursor-plugin/plugin.json`, `mcp.json`	Cursor plugin manifest and its MCP server
`gemini-extension.json`, `GEMINI.md`	Gemini CLI extension: installs GAIP's MCP server and tells the model when to use each tool
`packages/gaip-check/`	Python client: `check_agent("https://other-agent.example")`
`action.yml`, `packages/gaip-check-action/`	The check Action (`uses: tjcgraham-rgb/gaip-agents@v1`)
`watch/`	The GAIP Watch Action
`packages/aipref-signals/`	Dependency-free parser and test vectors for AI-preference signals (IETF AI Preferences `Content-Usage`, RSL licence links, W3C TDMRep, Content Signals)
`assets/`	GAIP logo (SVG, and a 400×400 PNG) and the specialist icons (SVG)
`llms-install.md`	Install steps for AI assistants that set up MCP servers themselves (Cline)

The registry records, listing kit, packages, Watch Action, skill and Gemini extension are copies of what GAIP's service generates; a check in the service's repository warns when a copy here falls out of step. The service itself runs at www.gaipagents.com.

What an answer means

Every answer states what was observed and when. It is not a certification, endorsement, ranking or universal score, and not legal, financial or insurance advice. Receipts are signed with GAIP's Ed25519 key, published at https://www.gaipagents.com/.well-known/gaip-receipt-keys.json.

Terms: https://www.gaipagents.com/terms
Privacy: https://www.gaipagents.com/privacy
Corrections and opt-out: https://www.gaipagents.com/corrections
Methodology: https://www.gaipagents.com/methodology
Security contact: https://www.gaipagents.com/.well-known/security.txt

Licence

MIT (see LICENSE) for everything in this repository.

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

Axiom Relay B
io.github.Itr3k
Free agent-service discovery, OpenAPI document checks, and receipt verification. No API key needed.
API Testing Agent Orchestration Security
101
MCP Verification Gate: check an MCP server or an A2A agent before you connect or delegate A
io.github.ogasurfproject-jpg
Check an A2A agent before you delegate, or an MCP server's measured conduct. Free, no key.
API Testing Developer Tools Testing & QA Tools
652
TAP Certified A
dev.theatlasproject
Check if an AI agent is certified; list the TAP Registry and certifications. Free, read-only.
Security AI & Machine Learning
41
Agora
io.github.mo-grantsmith
Find governed AI capabilities and verify signed receipts. Read-only, no account.
Search AI & Machine Learning Security
1

Related MCP Servers

proofrelay
Legal & Compliance Security
GENESISRE
A
license
A
quality
F
maintenance
Read-only ProofRelay MCP verifier for non-confidential evidence bundles. Exposes 22 public-safe tools, 11 resources, and 11 prompts for bundle integrity checks, receipt-chain review, checkpoint recommendations, MCP risk metadata review, and real-estate closing proof-pack readiness.
Updated 2 months ago (2026-08-27 13:02 UTC)
5
MIT
turva-mcp
Developer Tools Documentation Access Security
erekola
A
license
Not graded
quality
A
maintenance
Read-only MCP server that answers questions about turva.dev from its published data. Five tools return JSON: the service catalog with prices, contact and operator details, engagement principles and dated agent-readiness and security evidence with verification links. Connect over Streamable HTTP. You need no API key. The server does not scan other websites or run audits.
Updated 5 days ago (2026-10-15 22:09 UTC)
MIT
Trooth Networkofficial
Developer Tools Open Data Security
troothllc
A
license
Not graded
quality
B
maintenance
Remote, read-only MCP connector to check any company's witnessed trust record on the Trooth Network, across identity, security, privacy, and AI practices. Also does a neutral read of a domain's public security surface and verifies signed Trust Ledger Tokens. No key, no account.
Updated 3 days ago (2026-10-18 03:34 UTC)
1
MIT
Decision Room
Project Management Knowledge & Memory
metaversebldr7-web
A
license
Not graded
quality
B
maintenance
Enables proof-carrying project execution through a read-only remote MCP endpoint and WebMCP tools for managing Project Passports, task graphs, evidence-backed provider comparisons, route approvals, artifacts, verification records, and checkpoints without executing external providers.
Updated 2 months ago (2026-08-31 15:29 UTC)
MIT