Skip to main content

Metis FCA Handbook AI Harness — MCP Server

smithery badge

An MCP (Model Context Protocol) server that integrates the Metis FCA Handbook AI Harness into Claude Desktop and other MCP-compatible agents.

Tool name: evaluate_fca_handbook_applicability

Use this tool to analyze FCA Handbook applicability for a product, service, or firm. Returns structured compliance reasoning with verbatim handbook citations.

Why choose The Metis FCA Handbook AI Harness?

  • Efficiency Multiplies effectiveness of compliance advice. Saves £80+ in token fees per Harness run.

  • Deals with "Hard Problem", in which LLMs' token incentives prioritise training data so results are unreliable.

  • Verbatim citations Quotes verbatim entries from the FCA Handbook. Other AI systems struggle to do this.

  • Matches real-world need You do not have to start off knowing which sections you are looking for. Carries out structured searches across all 10,000+ FCA Handbook entries.

  • Secure Design Harness compartmentalisation, one-shot structure, and statelessness fits natively with emerging AI agent security standards such as OWASP Top 10 for Agentic Applications 2026.

  • AI Accessible Integrates easily with AI workflows and agents. Your LLM can use it as a tool.

Try the Harness Live

Experience the Harness interactively before integrating:

https://fcahandbookharnessimplementation.onrender.com

Email the-metis-fca-handbook-ai-harness@jbmd.co.uk and request a free temporary Access Code.

Ask compliance questions in natural language and watch each reasoning step unfold in real-time.

Design Principles

The Harness is built on proven principles:

  • Stateless — Each request is independent; no session coupling
  • One-shot — Complete analysis in a single call; no multi-turn state
  • Clear contract — Explicit input/output schemas for easy integration
  • Hosted — Single canonical source; no version drift or stale data

Use Cases

Compliance AI Platforms

Embed FCA reasoning as a service within your compliance platform. Users ask natural-language questions; your platform calls the Harness and presents structured reasoning.

AI Agent Workflows

Agents building compliance workflows can include FCA Handbook reasoning as a composed tool—no external API calls, just MCP configuration.

Compliance Review Automation

Integrate into document review or due-diligence pipelines. Automatically screen new rules against FCA applicability.

For Regulatory Screening

FS firms screening MCP servers will find:

  • Simple model: Stateless, no hidden state, no background jobs
  • Clear contract: Explicit input schema, output schema, error modes
  • Transparent updates: Version pinning; no automatic upgrades
  • Single point of failure: If the Harness is down, it is obvious; no cascading config issues
  • Audit-friendly: All calls logged centrally, not distributed

Quick Start

1. Get an API Key

Visit the Metis account dashboard:

https://fcahandbookharnessimplementation.onrender.com
  • Click "Create Account" (modal on the homepage)
  • Complete Stripe payment flow (accounts are paid)
  • Navigate to API Keys and generate a new key
  • Save it securely

2. Install the MCP Server

pip install fca-handbook-harness-mcp

3. Configure Claude Desktop

Edit your Claude Desktop config file:

File location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Add this server entry (create the file if it doesn't exist):

{
  "mcpServers": {
    "fca-handbook-harness": {
      "command": "fca-handbook-harness-mcp",
      "env": {
        "METIS_API_KEY": "sk_live_..."
      }
    }
  }
}

Replace sk_live_... with your actual API key from your Metis account.

4. Restart Claude Desktop

Quit and restart Claude Desktop. The evaluate_fca_handbook_applicability tool will now be available in agent workflows.

Using the Tool

The tool accepts two parameters:

  • user_input (required, max 5000 characters): Everything together as one piece of text — firm type, products/services, target market, regulatory question, etc.
  • analysis_mode (optional): "quick" (default, ~60-120 seconds) or "full" (longer, detailed conditional reasoning)

The tool returns:

  • summary: 2-3 sentence overview of applicability
  • entry_analysis: Retrieved FCA Handbook entries with reasoning
  • obligations: High-confidence, conditional, and low-confidence obligations
  • gaps: What the analysis couldn't determine from your input
  • refinement_suggestions: Follow-up information that would improve accuracy
  • citations: Verbatim quotes from FCA Handbook with binding levels (R=Rule, G=Guidance)
  • tokens: Token count for cost/complexity tracking

Troubleshooting

Tool not appearing in Claude Desktop:

  • Verify the config file path (platform-specific, see above)
  • Check that mcp_server.py path is absolute and correct
  • Restart Claude Desktop (not just reload)

401 Unauthorized:

  • Verify METIS_API_KEY is set in the config env
  • Check the key is correct (copy from dashboard again)
  • Ensure no extra spaces or newlines in the key

Connection timeout:

  • The analysis can take 60-120 seconds (quick mode) or longer (full mode)
  • Ensure you have internet access to fcahandbookharnessimplementation.onrender.com

Files

  • mcp_server.py — MCP server implementation (main entry point)
  • tool.json — Tool schema definition for LLMs and registries
  • server.json — MCP registry manifest (registry.modelcontextprotocol.io format)
  • requirements.txt — Python dependencies (mcp, requests)
  • init.py — Python package marker
  • README.md — This file
  • LICENSE — MIT License
  • .gitignore — Git ignore rules

Full API Documentation

For the complete HTTP API contract (request/response schemas, error codes, detailed examples), see the HTTP API documentation in the private implementation repository.

Support

For questions or issues, contact: the-metis-fca-handbook-ai-harness@jbmd.co.uk


Product: Metis FCA Handbook AI Harness
Version: 3.0.0
License: MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fca_handbook_harness_mcp-0.1.2.tar.gz (5.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fca_handbook_harness_mcp-0.1.2-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

Details for the file fca_handbook_harness_mcp-0.1.2.tar.gz.

File metadata

File hashes

Hashes for fca_handbook_harness_mcp-0.1.2.tar.gz
Algorithm Hash digest
SHA256 956a982a418d4fd35cfa17f9d5aecf95077f4d12b43d7c191b618b428d2f564b
MD5 ecaf553063d9551c14e3012534c790b2
BLAKE2b-256 944cda67c0e1789be46ceced68397d28a32148472043cbb4457e337cb13aed10

See more details on using hashes here.

File details

Details for the file fca_handbook_harness_mcp-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for fca_handbook_harness_mcp-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 827f376a74fe8a5a8dc79db8e67a2290e7432b674623424b4b5ad06b21f75c3a
MD5 8225648f0884156daf01d2794ce7c269
BLAKE2b-256 76f0f6cb17c8451b75db8fa027bb632247f3ede4c631066d09ffcfed561231a1

See more details on using hashes here.

Release history Release notifications | RSS feed

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

1 file

0.1.5

1 file

0.1.4

2 files

0.1.3

2 files

This release

0.1.2 This release

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page