io.github.cletcher/chaprola

@chaprola/mcp-server

MCP server for Chaprola — the agent-first data platform.

Gives AI agents 40 tools for structured data storage, querying, web search, URL fetching, scheduled jobs, and execution through the Model Context Protocol.

Quick Start

Claude Code

claude mcp add chaprola-mcp -e CHAPROLA_USERNAME=yourusername -e CHAPROLA_API_KEY=chp_yourkey -- npx @chaprola/mcp-server

Note: After installing, restart Claude Code to load the MCP server. The server description and tools will then be available to Claude.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "chaprola": {
      "command": "npx",
      "args": ["@chaprola/mcp-server"],
      "env": {
        "CHAPROLA_USERNAME": "yourusername",
        "CHAPROLA_API_KEY": "chp_yourkey"
      }
    }
  }
}

VS Code / Copilot

Add to .vscode/mcp.json:

{
  "servers": {
    "chaprola": {
      "command": "npx",
      "args": ["@chaprola/mcp-server"],
      "env": {
        "CHAPROLA_USERNAME": "yourusername",
        "CHAPROLA_API_KEY": "chp_yourkey"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "chaprola": {
      "command": "npx",
      "args": ["@chaprola/mcp-server"],
      "env": {
        "CHAPROLA_USERNAME": "yourusername",
        "CHAPROLA_API_KEY": "chp_yourkey"
      }
    }
  }
}

Getting Credentials

# Register (returns your API key — save it immediately)
curl -X POST https://api.chaprola.org/register \
  -H "Content-Type: application/json" \
  -d '{"username": "myname", "passcode": "my-secure-passcode-16chars"}'

Or use the chaprola_register tool after connecting.

Available Tools

Tool	Description
chaprola_hello	Health check
chaprola_register	Create account
chaprola_login	Login (get new API key)
chaprola_check_username	Check username availability
chaprola_delete_account	Delete account + all data
chaprola_sign_baa	Sign Business Associate Agreement (PHI only)
chaprola_baa_status	Check BAA status
chaprola_baa_text	Get BAA text
chaprola_import	Import JSON to Chaprola format
chaprola_import_url	Get presigned upload URL
chaprola_import_process	Process uploaded file
chaprola_import_download	Import from URL (CSV/Excel/JSON/Parquet)
chaprola_export	Export to JSON
chaprola_list	List files
chaprola_compile	Compile .CS source to .PR bytecode
chaprola_run	Execute .PR program
chaprola_run_status	Check async job status
chaprola_publish	Publish program for public access
chaprola_unpublish	Remove public access
chaprola_report	Run published program (no auth)
chaprola_export_report	Run program and save output
chaprola_download	Get presigned download URL
chaprola_query	Filter, aggregate, join data
chaprola_sort	Sort data file
chaprola_index	Build index on field
chaprola_merge	Merge two sorted files
chaprola_optimize	HULDRA nonlinear optimization
chaprola_optimize_status	Check optimization status
chaprola_email_inbox	List emails
chaprola_email_read	Read email
chaprola_email_send	Send email
chaprola_email_delete	Delete email
chaprola_search	Web search via Brave API
chaprola_fetch	Fetch URL content as markdown/text/JSON
chaprola_schedule	Create scheduled recurring job
chaprola_schedule_list	List scheduled jobs
chaprola_schedule_delete	Delete scheduled job

Resources

The server exposes reference documentation as MCP resources:

• chaprola://cookbook — Language cookbook with complete examples
• chaprola://endpoints — All 40 API endpoints
• chaprola://auth — Authentication reference
• chaprola://gotchas — Common mistakes to avoid

Environment Variables

Variable	Required	Description
CHAPROLA_USERNAME	Yes	Your registered username
CHAPROLA_API_KEY	Yes	Your API key (format: chp_ + 64 hex chars)

HIPAA / BAA

Non-PHI data works without a signed BAA. If handling Protected Health Information (PHI), a human must review and sign the BAA first. The server includes guardrails that warn agents when the BAA is not signed.

Links

• Website: chaprola.org
• API: api.chaprola.org
• Status: UptimeRobot