English Français العربية

io.github.cletcher/chaprola

Official registry Health

Serverless API backend: query, JOIN, pivot, batch ops, email, FHIR, programs via HTTP.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @chaprola/mcp-server
Claude Code 
claude mcp add chaprola -e 'CHAPROLA_USERNAME=<CHAPROLA_USERNAME>' -e 'CHAPROLA_API_KEY=<your chaprola_api_key>' -- npx -y @chaprola/mcp-server@1.4.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "chaprola": {
            "command": "npx",
            "args": [
                "-y",
                "@chaprola/mcp-server@1.4.3"
            ],
            "env": {
                "CHAPROLA_USERNAME": "<CHAPROLA_USERNAME>",
                "CHAPROLA_API_KEY": "<your chaprola_api_key>"
            }
        }
    }
}

Environment variables

  • CHAPROLA_USERNAME required Your Chaprola username (register at https://api.chaprola.org/register)
  • CHAPROLA_API_KEY required secret Your Chaprola API key (format: chp_ + 64 hex chars)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @chaprola/mcp-server
  2. Quick Start
  3. Getting Credentials
  4. Available Tools
  5. Resources
  6. Environment Variables
  7. HIPAA / BAA
  8. Links

@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

ToolDescription
chaprola_helloHealth check
chaprola_registerCreate account
chaprola_loginLogin (get new API key)
chaprola_check_usernameCheck username availability
chaprola_delete_accountDelete account + all data
chaprola_sign_baaSign Business Associate Agreement (PHI only)
chaprola_baa_statusCheck BAA status
chaprola_baa_textGet BAA text
chaprola_importImport JSON to Chaprola format
chaprola_import_urlGet presigned upload URL
chaprola_import_processProcess uploaded file
chaprola_import_downloadImport from URL (CSV/Excel/JSON/Parquet)
chaprola_exportExport to JSON
chaprola_listList files
chaprola_compileCompile .CS source to .PR bytecode
chaprola_runExecute .PR program
chaprola_run_statusCheck async job status
chaprola_publishPublish program for public access
chaprola_unpublishRemove public access
chaprola_reportRun published program (no auth)
chaprola_export_reportRun program and save output
chaprola_downloadGet presigned download URL
chaprola_queryFilter, aggregate, join data
chaprola_sortSort data file
chaprola_indexBuild index on field
chaprola_mergeMerge two sorted files
chaprola_optimizeHULDRA nonlinear optimization
chaprola_optimize_statusCheck optimization status
chaprola_email_inboxList emails
chaprola_email_readRead email
chaprola_email_sendSend email
chaprola_email_deleteDelete email
chaprola_searchWeb search via Brave API
chaprola_fetchFetch URL content as markdown/text/JSON
chaprola_scheduleCreate scheduled recurring job
chaprola_schedule_listList scheduled jobs
chaprola_schedule_deleteDelete 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

VariableRequiredDescription
CHAPROLA_USERNAMEYesYour registered username
CHAPROLA_API_KEYYesYour 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.

Frequently asked questions

What is io.github.cletcher/chaprola?

Serverless API backend: query, JOIN, pivot, batch ops, email, FHIR, programs via HTTP.

How do I install io.github.cletcher/chaprola?

It runs on your machine. In Claude Code: claude mcp add chaprola -e 'CHAPROLA_USERNAME=<CHAPROLA_USERNAME>' -e 'CHAPROLA_API_KEY=<your chaprola_api_key>' -- npx -y @chaprola/mcp-server@1.4.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.cletcher/chaprola need an API key?

Yes. It expects CHAPROLA_USERNAME, CHAPROLA_API_KEY, which you set in its configuration.

Is io.github.cletcher/chaprola open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.cletcher/chaprola?

It is published by cletcher. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.