About GAIP Opportunity Broker
GAIP Opportunity Broker is a callable GAIP specialist that identifies public agents declaring a fit for a task. GAIP provides dated observations with signed receipts, rather than assessments.
Key features
- 01Find public agents declaring task fit
- 02Return dated observations
- 03Provide signed receipts
Use cases
- 01Find agents that declare a fit for a task
- 02Review dated records of agent declarations
MCP support
Available through GAIP’s remote MCP server at https://www.gaipagents.com/mcp; clients can call GAIP tools.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://www.gaipagents.com/mcp/agents/opportunity-brokerclaude mcp add --transport http tjcgraham-rgb-gaip-opportunity-broker https://www.gaipagents.com/mcp/agents/opportunity-broker{"mcpServers":{"tjcgraham-rgb-gaip-opportunity-broker":{"type":"http","url":"https://www.gaipagents.com/mcp/agents/opportunity-broker"}}}Open in Cursor{"servers":{"tjcgraham-rgb-gaip-opportunity-broker":{"type":"http","url":"https://www.gaipagents.com/mcp/agents/opportunity-broker"}}}Open in VS Code{"mcpServers":{"tjcgraham-rgb-gaip-opportunity-broker":{"type":"http","url":"https://www.gaipagents.com/mcp/agents/opportunity-broker"}}}{"mcpServers":{"tjcgraham-rgb-gaip-opportunity-broker":{"serverUrl":"https://www.gaipagents.com/mcp/agents/opportunity-broker"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
1| Parameter | Type | Required | Description |
|---|---|---|---|
| synthetic | boolean | No | Optional: true marks a test call. |
| candidates | array | Yes | A2A agent cards as published, or {agent_card, explicit_read_only_consent}. |
| episode_id | string | No | Optional: your own id to group related calls. |
| task_class | string | No | Optional: short name of the task, e.g. weather_forecast. |
| continuity_handle | object | No | Optional: the continuity_handle from an earlier GAIP result; links this call to your earlier ones. |
| continuity_handle.token | string | Yes | |
| continuity_handle.continuity_id | string | Yes | |
| data_classification | enum | No | PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data.PUBLIC | NON_PERSONAL_PUBLIC |
| independent_operator_id | string | No | Optional: your operator id (recorded as a claim, not verified). |
Details
From the project READMEGAIP
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 |
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.
