{
  "markdown": "# @chaprola/mcp-server\n\nMCP server for [Chaprola](https://chaprola.org) — the agent-first data platform.\n\nGives AI agents 40 tools for structured data storage, querying, web search, URL fetching, scheduled jobs, and execution through the [Model Context Protocol](https://modelcontextprotocol.io).\n\n## Quick Start\n\n### Claude Code\n\n```bash\nclaude mcp add chaprola-mcp -e CHAPROLA_USERNAME=yourusername -e CHAPROLA_API_KEY=chp_yourkey -- npx @chaprola/mcp-server\n```\n\n> **Note:** After installing, restart Claude Code to load the MCP server. The server description and tools will then be available to Claude.\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"chaprola\": {\n      \"command\": \"npx\",\n      \"args\": [\"@chaprola/mcp-server\"],\n      \"env\": {\n        \"CHAPROLA_USERNAME\": \"yourusername\",\n        \"CHAPROLA_API_KEY\": \"chp_yourkey\"\n      }\n    }\n  }\n}\n```\n\n### VS Code / Copilot\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"chaprola\": {\n      \"command\": \"npx\",\n      \"args\": [\"@chaprola/mcp-server\"],\n      \"env\": {\n        \"CHAPROLA_USERNAME\": \"yourusername\",\n        \"CHAPROLA_API_KEY\": \"chp_yourkey\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"chaprola\": {\n      \"command\": \"npx\",\n      \"args\": [\"@chaprola/mcp-server\"],\n      \"env\": {\n        \"CHAPROLA_USERNAME\": \"yourusername\",\n        \"CHAPROLA_API_KEY\": \"chp_yourkey\"\n      }\n    }\n  }\n}\n```\n\n## Getting Credentials\n\n```bash\n# Register (returns your API key — save it immediately)\ncurl -X POST https://api.chaprola.org/register \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"username\": \"myname\", \"passcode\": \"my-secure-passcode-16chars\"}'\n```\n\nOr use the `chaprola_register` tool after connecting.\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `chaprola_hello` | Health check |\n| `chaprola_register` | Create account |\n| `chaprola_login` | Login (get new API key) |\n| `chaprola_check_username` | Check username availability |\n| `chaprola_delete_account` | Delete account + all data |\n| `chaprola_sign_baa` | Sign Business Associate Agreement (PHI only) |\n| `chaprola_baa_status` | Check BAA status |\n| `chaprola_baa_text` | Get BAA text |\n| `chaprola_import` | Import JSON to Chaprola format |\n| `chaprola_import_url` | Get presigned upload URL |\n| `chaprola_import_process` | Process uploaded file |\n| `chaprola_import_download` | Import from URL (CSV/Excel/JSON/Parquet) |\n| `chaprola_export` | Export to JSON |\n| `chaprola_list` | List files |\n| `chaprola_compile` | Compile .CS source to .PR bytecode |\n| `chaprola_run` | Execute .PR program |\n| `chaprola_run_status` | Check async job status |\n| `chaprola_publish` | Publish program for public access |\n| `chaprola_unpublish` | Remove public access |\n| `chaprola_report` | Run published program (no auth) |\n| `chaprola_export_report` | Run program and save output |\n| `chaprola_download` | Get presigned download URL |\n| `chaprola_query` | Filter, aggregate, join data |\n| `chaprola_sort` | Sort data file |\n| `chaprola_index` | Build index on field |\n| `chaprola_merge` | Merge two sorted files |\n| `chaprola_optimize` | HULDRA nonlinear optimization |\n| `chaprola_optimize_status` | Check optimization status |\n| `chaprola_email_inbox` | List emails |\n| `chaprola_email_read` | Read email |\n| `chaprola_email_send` | Send email |\n| `chaprola_email_delete` | Delete email |\n| `chaprola_search` | Web search via Brave API |\n| `chaprola_fetch` | Fetch URL content as markdown/text/JSON |\n| `chaprola_schedule` | Create scheduled recurring job |\n| `chaprola_schedule_list` | List scheduled jobs |\n| `chaprola_schedule_delete` | Delete scheduled job |\n\n## Resources\n\nThe server exposes reference documentation as MCP resources:\n\n- `chaprola://cookbook` — Language cookbook with complete examples\n- `chaprola://endpoints` — All 40 API endpoints\n- `chaprola://auth` — Authentication reference\n- `chaprola://gotchas` — Common mistakes to avoid\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `CHAPROLA_USERNAME` | Yes | Your registered username |\n| `CHAPROLA_API_KEY` | Yes | Your API key (format: `chp_` + 64 hex chars) |\n\n## HIPAA / BAA\n\nNon-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.\n\n## Links\n\n- Website: [chaprola.org](https://chaprola.org)\n- API: [api.chaprola.org](https://api.chaprola.org/hello)\n- Status: [UptimeRobot](https://stats.uptimerobot.com/1gkN4Tx0RX)\n",
  "bytes": 4636,
  "sha": "ea55fe51c498e661cd2404639a1332d7d0bce4d899b81421096392e6d582e7be",
  "repo_slug": "cletcher/chaprola-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_cletcher_chaprola_8ad746f7/readme"
}