MCP server

Connect Rowvia tables to an AI agent

Rowvia MCP lets an authorized chatbot or agent work with existing Rowvia tables: list and find tables, read schemas, prompts, and summaries, add rows from URLs, text, inline files, or ChatGPT attachments, optionally run processing, check status, search rows, and read selected rows or results.

Open app Agent Markdown
Setup

Quick setup

1. Create a token

Open Rowvia.ai Profile -> Integrations. For a normal agent, use the scopes tables:read, rows:read, row:add, and row:process. Add rows:update only for explicit cell corrections.

2. Limit the table when possible

For repeated workflows, prefer a token restricted to one table. The agent then works only with the table the user assigned.

3. Configure the client

A local MCP client needs the stdio server plus ROWVIA_API_BASE_URL and ROWVIA_API_TOKEN environment variables. ChatGPT needs an HTTPS MCP endpoint, not local stdio JSON.

MCP client configuration

The command below is for local development from the Rowvia monorepo. For external installation, use the command published in integration settings. Optional cell updates are disabled until ROWVIA_MCP_ENABLE_ROW_UPDATE=true is set.

{
  "mcpServers": {
    "rowvia": {
      "command": "npx",
      "args": ["--workspace", "@rowvia/mcp", "rowvia-mcp"],
      "env": {
        "ROWVIA_API_BASE_URL": "https://api.rowvia.ai",
        "ROWVIA_API_TOKEN": "rvia_...",
        "ROWVIA_MCP_ENABLE_ROW_UPDATE": "false"
      }
    }
  }
}
Workflow

How the agent should work

1

Find an existing table

Start with rowvia_table_list or rowvia_table_find. If the user did not name an exact table, ask them to confirm the target table.

2

Read schema and prompts

Use rowvia_table_get_schema or the rowvia://tables/{table_id}/schema resource. For automation, use table_id and row_id; row_index is only a display position.

3

Add rows

rowvia_row_add adds URL, text, and small inline document rows to an existing table. For public or temporarily shared documents, prefer source=url; Rowvia downloads PDF, DOCX, TXT, MD, or HTML server-side. HTML URLs are stored as Markdown snapshots. For a document attached in ChatGPT, use rowvia_row_add_chatgpt_document with a top-level file object containing HTTPS download_url, file_id, mime_type, and file_name.

4

Start processing explicitly

rowvia_row_add has process_after_add defaulting to false. Before larger runs, call rowvia_table_get_pending_work and start processing through rowvia_table_start_processing.

5

Track status and read results

Track the returned processing_run_id with rowvia_processing_get_status. Read results with rowvia_row_get_results or rowvia_row_get using column projection.

MCP

Available tools

Tables and schema

  • rowvia_table_list
  • rowvia_table_find
  • rowvia_table_get_schema
  • rowvia_table_get_summary
  • rowvia_table_get_pending_work

Rows and documents

  • rowvia_row_add_chatgpt_document
  • rowvia_row_add
  • rowvia_row_list
  • rowvia_row_search
  • rowvia_row_get
  • rowvia_row_get_results

Processing

  • rowvia_table_start_processing
  • rowvia_processing_get_status

Optional correction

  • rowvia_row_update
Context

Resources

  • rowvia://tables
  • rowvia://tables/{table_id}/schema
  • rowvia://tables/{table_id}/rows?offset=0&limit=20

Chatbot safety rules

  • Never paste the full token into chat or logs.
  • Do not log full ChatGPT download_url values, and never send Rowvia tokens to imported URLs.
  • Prefer table-restricted tokens for automations.
  • Read rows through bounded windows, not by dumping the whole table.
  • Do not start larger processing runs without explicit confirmation and a pending-work estimate.
  • An empty output cell is processable; a non-empty output cell is skipped according to Rowvia's normal rules.
  • The MCP tools do not delete rows or tables, create tables, change schema, edit prompts, or change billing/admin settings.
  • Optional rowvia_row_update is disabled by default and requires ROWVIA_MCP_ENABLE_ROW_UPDATE=true plus a token with rows:update.