pension-pro-mcp

PensionPro MCP Server

A local, open-source MCP server that provides AI assistants with tools to interact with the PensionPro REST API.

Features

• Plan Lookup & Search — Search plans by name, status, type, or client. Get comprehensive plan details with contacts, cycles, and fee schedules.
• Project & Task Workflow — Search projects, view task details, complete/uncomplete tasks, reassign tasks, and create projects from templates.
• Client & Contact Lookup — Search clients and contacts, view client details with associated plans.
• To-Do Management — Search, create, and update to-dos linked to plans, projects, or contacts.
• Notes — Add and retrieve notes on plans, projects, tasks, and contacts.

Prerequisites

• Python 3.12+
• A PensionPro API key and username

Installation

Install from PyPI:

pip install pension-pro-mcp

Or run directly with uvx (no install required):

uvx pension-pro-mcp

Configuration

Set the following environment variables:

export PENSION_PRO_API_KEY=your_api_key
export PENSION_PRO_USERNAME=your_username

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "pension-pro": {
      "command": "uvx",
      "args": ["pension-pro-mcp"],
      "env": {
        "PENSION_PRO_API_KEY": "your_api_key",
        "PENSION_PRO_USERNAME": "your_username"
      }
    }
  }
}

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "pension-pro": {
      "command": "uvx",
      "args": ["pension-pro-mcp"],
      "env": {
        "PENSION_PRO_API_KEY": "your_api_key",
        "PENSION_PRO_USERNAME": "your_username"
      }
    }
  }
}

Available Tools

Tool	Description
search_plans	Search and filter plans by name, status, type, or client
get_plan_details	Get plan with contacts, cycles, services, investments, fees
get_plan_projects	Get projects for a plan with task completion summaries
search_projects	Search and filter projects by status, type, or plan
get_project_details	Get project with task groups, tasks, participants, notes, and files
get_task_details	Get a single task with state, assignment, and notes
complete_task	Mark a task as complete
uncomplete_task	Revert a task to incomplete
reassign_task	Reassign a task to a different employee
create_project_from_template	Create a new project from a template
search_clients	Search and filter clients by company name
get_client_details	Get client with plans and notes
search_contacts	Search and filter contacts by name or client
search_todos	Search and filter to-dos
get_todo	Get a to-do with its comments
create_todo	Create a new to-do linked to an entity
update_todo	Update a to-do's details
add_note	Add a note to a plan, project, task, or contact
get_notes	Get notes for an entity
search_api_paths	Search PensionPro API endpoints by keyword
get_api_endpoint	Get full details for a specific API endpoint
search_api_schemas	Search API data models/schemas by keyword
get_api_schema	Get the full definition of an API data model
search_help_articles	Search PensionPro help center articles by keyword
get_help_article	Get the full content of a help article
list_help_sections	List available help sections with article counts

Development

git clone https://github.com/douglaslinsmeyer/pension-pro-mcp.git
cd pension-pro-mcp
pip install -e ".[dev]"
pytest

Refreshing Help Articles

The bundled help articles can be refreshed from the PensionPro knowledge base:

python scripts/scrape_docs.py

License

MIT