Metadata-Version: 2.4
Name: ragento-mcp
Version: 0.2.4
Summary: Ragento Analytics MCP server — ingest, query, and analyze your data from Cursor and agent IDEs
Project-URL: Homepage, https://ragento.ai/mcp
Project-URL: Documentation, https://ragento.ai/mcp
Project-URL: Repository, https://github.com/ragento-ai/ragento-analytics
Project-URL: Changelog, https://ragento.ai/mcp#faq
Author-email: "Ragento Analytics, Inc." <ragento.ai@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: analytics,bi,claude,cursor,data,mcp,ragento
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.2.0
Description-Content-Type: text/markdown

<p align="center">
  <a href="https://ragento.ai/mcp">
    <img src="data:image/png;base64,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" alt="Ragento" width="220" />
  </a>
</p>

<h1 align="center">Ragento MCP</h1>

<p align="center">
  <strong>Analytics inside Cursor, Claude Code, Windsurf, and Antigravity.</strong><br/>
  Purpose-built MCP tools for ingest, catalog, SQL, NL query, profiling, and deep analysis.
</p>

<p align="center">
  <a href="https://ragento.ai/mcp">Install guide</a> ·
  <a href="https://ragento.ai/mcp/why">Why Ragento MCP</a> ·
  <a href="https://app.ragento.ai">Platform</a>
</p>

---

## Quick install

```bash
curl -fsSL https://ragento.ai/install/mcp.sh | bash
```

Then **enable Ragento** in your IDE's MCP settings. Sign-in opens automatically in the browser (`app.ragento.ai`) and is saved locally.

## Manual config

Add to `~/.cursor/mcp.json` (or your IDE's MCP config):

```json
{
  "mcpServers": {
    "ragento": {
      "command": "uvx",
      "args": ["ragento-mcp@latest"],
      "env": {
        "RAGENTO_API_URL": "https://backend.ragento.ai/api/v1",
        "RAGENTO_APP_URL": "https://app.ragento.ai"
      }
    }
  }
}
```

| IDE | Config path |
|-----|-------------|
| Cursor | `~/.cursor/mcp.json` |
| Claude Code | `~/.claude.json` or project `.mcp.json` |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
| Antigravity | `~/.gemini/antigravity/mcp_config.json` |

## How auth works

1. Enable the MCP server in your IDE (stdio process starts).
2. If not signed in, your browser opens `app.ragento.ai` for OAuth.
3. Approve access once — tokens save to `~/.config/ragento-mcp/credentials.json` (auto-refresh, ~90 days).
4. Ask your agent to list sources, ingest, or query — **no manual `ragento_connect` step**.

Use `ragento_disconnect` only to switch accounts or sign out.

## Tools

| Tool | Purpose |
|------|---------|
| `ragento_list_sources` | List your data sources |
| `ragento_get_catalog` | User-scoped tables, columns, SQL hints |
| `ragento_ingest` | CSV, databases, API captures, text docs |
| `ragento_wait_for_source` | Poll until ingestion / profiling completes |
| `ragento_run_sql` | Execute SQL on your sources |
| `ragento_query` | Natural-language answers (NL2SQL) |
| `ragento_fetch_data` | NL or SQL → table/chart artifacts |
| `ragento_analyze` | Deep multi-step investigation |
| `ragento_get_profile` | Sentinel column classifications |
| `ragento_business_context` | MDL, graphs, memory, documents |
| `ragento_interview_context` | Guided KPI / metric capture |
| `ragento_get_insights` | Insight feed and discovery |
| `ragento_connect` | Optional manual re-login |
| `ragento_disconnect` | Sign out on this machine |

## Environment

| Variable | Default | Description |
|----------|---------|-------------|
| `RAGENTO_API_URL` | `https://backend.ragento.ai/api/v1` | API gateway |
| `RAGENTO_APP_URL` | `https://app.ragento.ai` | OAuth login |
| `RAGENTO_MCP_AUTO_AUTH` | `1` | Set `0` to disable automatic browser sign-in |
| `RAGENTO_MCP_TOKEN` | — | Legacy static token (skips OAuth) |

## CLI helpers

```bash
uvx ragento-mcp@latest install-cursor   # write ~/.cursor/mcp.json
uvx ragento-mcp@latest                  # run stdio MCP server
```

## License

MIT — see [LICENSE](LICENSE).
