Metadata-Version: 2.4
Name: savvly-mcp-server
Version: 1.0.24
Summary: Savvly MCP Server — stdio transport for Claude Desktop, Cursor, Windsurf, and other MCP-compatible AI agents
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 (Python)

Savvly MCP server — stdio transport for Claude Desktop, Cursor, Windsurf, and
other MCP-compatible AI agents. Exposes 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 published to npm as
`@savvly/mcp-server` 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"]
    }
  }
}
```

## Configuration

| Env var | Default | Purpose |
| --- | --- | --- |
| `ADVISOR_FUNCTIONS_URL` | `https://savvly-estimator.azurewebsites.net` | Projection backend. |
| `ADVISOR_FUNCTIONS_TIMEOUT_MS` | `15000` | Upstream request timeout. |

Projection tools call Savvly's hosted estimator; the product/comparison/FAQ/Q&A
content is bundled in the package and served offline.

## License

Apache-2.0.

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