ragento-mcp 0.2.3

Ragento Analytics MCP server — ingest, query, and analyze your data from Cursor and agent IDEs

Ragento MCP

Analytics inside Cursor, Claude Code, Windsurf, and Antigravity.
Purpose-built MCP tools for ingest, catalog, SQL, NL query, profiling, and deep analysis.

Install guide · Why Ragento MCP · Platform

---

Quick install

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):

{
  "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

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

License

MIT — see LICENSE.