Metadata-Version: 2.4
Name: savvly-mcp-server
Version: 1.0.32
Summary: Savvly Longevity Benefit Fund: product, comparisons, eligibility, and retirement projections.
Project-URL: Homepage, https://savvly.com
Project-URL: Repository, https://github.com/Savvly/savvly-public-api
Author: Savvly
License-Expression: Apache-2.0
Keywords: ai-agent,longevity,mcp,model-context-protocol,retirement,savvly
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.12
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == 'dev'
Description-Content-Type: text/markdown

# savvly-mcp-server (PyPI)

**Savvly Longevity Benefit Fund: product, comparisons, eligibility, and retirement projections.**
Stdio MCP server that gives Claude Desktop, Cursor, Windsurf, and other
MCP-compatible AI agents access to Savvly product info, eligibility checks,
Savvly-vs-alternative comparisons, an audience-tagged Q&A library, and
retirement / lump-sum / monthly projections (with inline MCP Apps chart
widgets).

This is the Python distribution of the same server also published to npm as
`@savvly/mcp-server`, to NuGet as `Savvly.McpServer`, and to the official MCP
Registry as `com.savvly/savvly`.

## Install & run

```bash
uvx savvly-mcp-server
# or
pipx run savvly-mcp-server
# or
pip install savvly-mcp-server && savvly-mcp
```

### Claude Desktop / Cursor config

```json
{
  "mcpServers": {
    "savvly": {
      "command": "uvx",
      "args": ["savvly-mcp-server"]
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `get_savvly_product_info` | Complete product details |
| `compare_savvly_vs_alternative` | Comparison vs annuities / target-date funds / etc. |
| `project_savvly_lumpsum` | Lump-sum payout projection |
| `project_savvly_monthly` | Monthly contribution projection |
| `project_retirement_with_savvly` | Full retirement simulation |
| `check_savvly_eligibility` | Eligibility check |
| `get_savvly_faq` | FAQ filtered by topic |
| `search_savvly_content` | Audience-tagged Q&A library search |

Projection tools emit interactive MCP Apps chart widgets on hosts that support them.

## Resources

- `savvly://product/overview`
- `savvly://product/comparison-matrix`
- `savvly://product/payout-schedule`
- `savvly://content/qa-library`

## Remote alternative

Prefer a hosted endpoint? Connect via Streamable HTTP at `https://api.savvly.com/mcp`.

## License

Apache-2.0.

<!-- mcp-name: com.savvly/savvly -->
