XframeworkID MCP Server

Model Context Protocol server that exposes the XframeworkID registry of labelled bond disclosure documents (frameworks, SPOs, impact reports, assurance, certifications, EU GBS reviews, academic research) to Claude and other MCP clients.

What it does

Lets a Claude conversation:

• Resolve any XFID (document), XPID (person), or XOID (organization) to its registry data
• Search ~10,800 documents by query, type, year, country
• Look up issuers and their full disclosure chains
• Look up analysts, researchers, issuance staff, bankers and their published work
• Find related documents (framework ↔ SPO ↔ impact ↔ assurance)
• Cite XFIDs in responses with permanent URLs

All queries hit the public xframework.id JSON API — no authentication required, no local database needed.

Installation

From PyPI (recommended once published)

pip install xframework-mcp

From source

git clone https://github.com/iandhoward/XframeworkID.git
cd XframeworkID/mcp_server
pip install -e .

Configure Claude Desktop

Add to your Claude Desktop MCP configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "xframework-id": {
      "command": "xframework-mcp"
    }
  }
}

Restart Claude Desktop. You should see a 🔌 icon indicating MCP servers are connected.

Configure other MCP clients

The server uses stdio transport. For any MCP client, run:

xframework-mcp

It will read MCP messages from stdin and write to stdout.

Tools provided

Example queries Claude can answer with this server

• "What are all the disclosure documents Iberdrola has published?"
• "Show me the framework, SPO, and impact reports for the IFC Forests Bond."
• "Find academic papers about greenium pricing."
• "Who reviewed the Conservation Fund's Working Forests Green Bond?"
• "What's at XFID XF-A3B7K2M-9?"
• "List all 2025 SPOs in the registry."
• "What documents has Caroline Flammer published in this registry?"

Technical notes

• HTTP client: httpx.AsyncClient with a 15s timeout, User-Agent: xframework-mcp/0.1.0.
• Caching: relies on the API's Cache-Control headers (60s for search, 300s for documents).
• Error handling: tool calls return JSON {"error": "..."} payloads on failure rather than raising.
• No authentication: only reads public registry data. No secrets, no rate limits beyond the public API's.

What this server does NOT do

• Submit corrections or new documents (use https://xframework.id/contact).
• Access paid features (investor comparison tool, page view tracking).
• Modify the registry. Read-only.

License

MIT. See repository root.

About XframeworkID

XframeworkID is an open registry that assigns permanent, content-based identifiers (XFIDs) to extra-financial disclosure documents associated with labelled bond issuances. Founded by Ian Howard (ex-Sustainalytics SPO business lead, ex-Climate Bonds Initiative data lead). The registry exists because 23% of these documents have already disappeared from their published URLs — see Deleting the Receipts.

For full documentation see https://xframework.id/llms-full.txt.