> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soriaanalytics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Overview

> Connect AI assistants like Claude Code directly to Soria tools using the Model Context Protocol.

The Model Context Protocol (MCP) lets AI assistants call Soria tools directly from your editor or terminal. Instead of copying data in and out manually, your AI assistant can run scrapers, query the warehouse, and manage the full data pipeline without leaving the chat.

Soria exposes a full MCP server at `/mcp/` on the backend. You can connect to it in two ways:

* **MCP proxy** (recommended) — a stdio server you run locally that forwards to any Soria backend. Supports switching between environments without restarting Claude.
* **Direct HTTP** — connect directly to a specific backend URL. Simpler, but requires a reconnect to change environments.

## Available tools

All Soria operations are available as MCP tools, grouped by category.

| Category    | Tools                                                                             |
| ----------- | --------------------------------------------------------------------------------- |
| Ingestion   | `scraper_manage`, `scraper_run`, `scraper_upload_urls`, `scraper_confirm_uploads` |
| Schema      | `schema_manage`, `schema_mappings`                                                |
| Processing  | `detection_run`, `extraction_run`, `validation_run`, `value_manage`               |
| Warehouse   | `warehouse_query`, `warehouse_materialize`                                        |
| Models      | `sql_model_save`, `sql_model_list`, `sql_model_get`, `sql_model_delete`           |
| Dashboards  | `list_dashboard_pages`, `get_dashboard_page`, `get_dashboard_data`                |
| Workspaces  | `workspace_manage`                                                                |
| Search      | `search`, `search_manage`                                                         |
| News        | `news_pipeline`, `news_branches`, `news_events`, `news_articles`                  |
| Environment | `environment_list`, `environment_switch`                                          |

The `environment_list` and `environment_switch` tools are built into the MCP proxy itself. They let you discover and switch between Soria backends — local, staging, production, or PR preview environments — without restarting your AI assistant.

## Next steps

<CardGroup cols={2}>
  <Card title="Connecting" icon="plug" href="/mcp/connecting">
    Set up the MCP proxy or a direct HTTP connection
  </Card>

  <Card title="Ingestion tools" icon="download" href="/mcp/tools/scraper-manage">
    Manage scrapers and ingest new data sources
  </Card>

  <Card title="Pipeline tools" icon="pipe-section" href="/mcp/tools/schema">
    Schema, extraction, validation, and value mapping
  </Card>

  <Card title="Warehouse & models" icon="database" href="/mcp/tools/warehouse-query">
    Query the warehouse and build SQL models
  </Card>

  <Card title="Dashboard tools" icon="chart-bar" href="/mcp/tools/dashboard-tools">
    List pages, fetch data, and explore dashboards
  </Card>

  <Card title="Search & news" icon="newspaper" href="/mcp/tools/search">
    Search across datasets and surface news intelligence
  </Card>
</CardGroup>