Metadata-Version: 2.4
Name: ragento-mcp
Version: 0.2.3
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="https://www.ragento.ai/logo.png" 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).
