# FedMCP Installation Guide
## Quick Install Commands
### For Claude Code (CLI/Terminal)
```bash
curl -fsSL https://raw.githubusercontent.com/northernvariables/CanadaGPT/main/packages/fedmcp/scripts/install-claude-code.sh | bash
```
This command will:
1. Install the FedMCP Python package
2. Add the MCP server to Claude Code with user scope
3. Configure permissions to auto-approve all FedMCP tools (pattern: `mcp__fedmcp__*`)
4. Optionally prompt for CanadaGPT PRO API key (10,000 requests/hour vs 100/hr free)
5. Optionally prompt for CanLII API key for legal search
### For Claude Desktop (macOS/Windows)
```bash
curl -fsSL https://raw.githubusercontent.com/northernvariables/CanadaGPT/main/packages/fedmcp/scripts/install-claude-desktop.sh | bash
```
After running, restart Claude Desktop.
---
## Manual Installation Steps
### Claude Code Manual Setup
Step 1: Install the Python package
```bash
pip install git+https://github.com/northernvariables/CanadaGPT.git#subdirectory=packages/fedmcp
```
Step 2: Add MCP server to Claude Code
```bash
claude mcp add --transport stdio --scope user fedmcp -- python -m fedmcp.server
```
Step 3: Enable auto-approval of all FedMCP tools
Edit `~/.claude/settings.json` and add:
```json
{
"permissions": {
"allow": ["mcp__fedmcp__*"]
}
}
```
### Claude Desktop Manual Setup
Step 1: Install the Python package
```bash
pip install git+https://github.com/northernvariables/CanadaGPT.git#subdirectory=packages/fedmcp
```
Step 2: Edit Claude Desktop configuration file
File locations:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
Add this configuration:
```json
{
"mcpServers": {
"fedmcp": {
"command": "python",
"args": ["-m", "fedmcp.server"]
}
}
}
```
Step 3: Restart Claude Desktop
---
## Auto-Approve Permissions
To enable all FedMCP tools without individual approval prompts in Claude Code:
File: `~/.claude/settings.json`
```json
{
"permissions": {
"allow": ["mcp__fedmcp__*"]
}
}
```
The pattern `mcp__fedmcp__*` matches all 86+ tools from FedMCP (75 FREE + 11 PRO).
---
## CanadaGPT PRO API Key (Optional)
PRO subscribers get:
- **10,000 requests/hour** (vs 100/hr for free tier)
- **11 exclusive accountability tools**: conflict detection, money tracing, MP scorecards, cross-references, and more
Get your API key:
1. Subscribe to PRO at https://canadagpt.ca/pricing
2. Generate API key at https://canadagpt.ca/settings#fedmcp-keys
3. Add to your MCP configuration:
Claude Code:
```bash
claude mcp remove fedmcp
claude mcp add --transport stdio --scope user --env FEDMCP_API_KEY=YOUR_KEY fedmcp -- python -m fedmcp.server
```
Claude Desktop - add to config:
```json
"env": {
"FEDMCP_API_KEY": "your_key_here"
}
```
---
## Optional: CanLII API Key
For Canadian legal case search capabilities:
1. Request free API key: https://www.canlii.org/en/feedback/feedback.html
2. Add to configuration:
Claude Code:
```bash
claude mcp remove fedmcp
claude mcp add --transport stdio --scope user --env CANLII_API_KEY=YOUR_KEY fedmcp -- python -m fedmcp.server
```
Claude Desktop - add to config:
```json
"env": {
"CANLII_API_KEY": "your_key_here"
}
```
---
## Verify Installation
Claude Code:
```bash
claude mcp list
# Inside Claude Code: /mcp
```
Claude Desktop: Check for tools icon (🔧) with FedMCP tools.
---
## Available Tools (86+)
### FREE Tools (75+)
- Parliamentary debates and Hansard transcripts
- MP voting records and expenses
- Bill tracking and legislative progress
- Lobbying registrations and communications
- Federal contracts and grants
- Political contributions
- Canadian case law (with CanLII key)
- Citizen petitions and government responses
- Fact-checking against parliamentary data
### PRO-Only Tools (11)
- MP Performance Scorecards
- Conflict of Interest Detection
- Money Flow Tracing
- MP Lobbying Contacts
- Bill Lobbying Analysis
- Cross-Reference Search
- Enriched MP/Bill Data
- Committee Activity Metrics
---
## Example Prompts
- "What bills are currently being debated in Parliament?"
- "Show me the voting record for [MP name]"
- "Who is lobbying the government on [topic]?"
- "Find my MP by postal code [postal code]"
- "Track the progress of Bill C-[number]"
---
## Troubleshooting
| Issue | Solution |
|-------|----------|
| Module not found | Ensure Python 3.10+ installed |
| Tools not appearing | Restart Claude Desktop/Code |
| Permission denied | Add `mcp__fedmcp__*` to settings.json |
---
Source: https://github.com/northernvariables/CanadaGPT/tree/main/packages/fedmcp
