@casera-tech/mcp-server

MCP (Model Context Protocol) server for the Casera API — lets AI coding agents authenticate as developers, manage OAuth integrations with clients, create cases, place orders, manage hot-links, and explore the sandbox environment.

Built for developers integrating with Casera using AI-assisted development tools like Claude Desktop, Cursor, Windsurf, VS Code Copilot, and others.

What's included

🔧 Tools (30)

Authentication & Developer Management (12)

| Tool | Description | |------|-------------| | developer-login | Log in with email + password (triggers MFA) | | developer-verify-mfa | Complete MFA with the 6-digit code from email | | refresh-session | Refresh your developer session token | | request-auth-code | Generate an OAuth auth code + consent URL for client | | exchange-token | Exchange a consent code for real access/refresh tokens | | refresh-integration-token | Refresh an integration's access token | | get-developer-settings | View your developer key, profile, and URLs | | update-developer-settings | Update profile or rotate secrets | | list-integrations | List all client integrations | | set-active-integration | Switch which integration token is used for API calls | | auth-status | View current authentication state | | developer-logout | Clear session and stored tokens |

Ordering & Products (10)

| Tool | Description | |------|-------------| | list-product-catalogue | Browse all products & packs with base pricing | | submit-conveyancing-details | Submit property details (type, address, centroid) to an order — triggers hazard assessment | | get-available-products | Get per-order products, packs, risks, and suggested products (requires conveyancing details) | | create-case | Create a new case | | create-order | Create an order within a case | | add-products | Add products/packs to an order | | place-order | Place an order (triggers webhook lifecycle) | | get-order | Get order details & status | | list-orders | List all orders | | create-hot-link | Generate a one-click ordering URL |

Hot-Links (2)

| Tool | Description | |------|-------------| | check-link-status | Check hot-link status (Pending/Consumed/Expired) | | list-links | List all developer hot-links |

Sandbox (5)

| Tool | Description | |------|-------------| | get-sandbox-credentials | Get sandbox access token & client ID | | trigger-webhook | Fire a test webhook event | | webhook-logs | View sandbox webhook delivery logs | | sandbox-status | View sandbox state counts | | reset-sandbox | Clear all sandbox data | | rotate-webhook-secret | Rotate sandbox webhook signing secret |

📚 Resources (9)

Integration guide sections your agent can read for context:

| Resource | URI | |----------|-----| | Quickstart | casera://guide/quickstart | | Authentication & OAuth | casera://guide/authentication | | Products, Packs & Ordering | casera://guide/products | | Risk & Recommendations | casera://guide/risk | | Hot-Link Ordering | casera://guide/hot-links | | Webhooks | casera://guide/webhooks | | Sandbox Environment | casera://guide/sandbox | | Token Reference | casera://guide/tokens | | Error Handling | casera://guide/errors |

💬 Prompts (5)

Pre-built conversation starters for common integration tasks:

| Prompt | Description | |--------|-------------| | integrate-oauth | Full OAuth consent flow implementation | | setup-webhook-handler | Production-ready webhook handler with HMAC verification | | implement-pack-ordering | End-to-end pack ordering walkthrough | | test-hot-links | Hot-link creation and testing flow | | explore-sandbox | Interactive sandbox environment tour |

Installation

npm install -g @casera-tech/mcp-server

Or use npx without installing:

npx @casera-tech/mcp-server

Configuration

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | CASERA_SANDBOX_TOKEN | No | — | Pre-set sandbox token (optional — you can also use developer-login + get-sandbox-credentials) | | CASERA_API_URL | No | https://api.casera.co.uk | API base URL |

Authentication Modes

Option 1: Interactive Login (Recommended) No env vars needed. Use the developer-login tool to authenticate with your email/password + MFA. Then use get-sandbox-credentials for sandbox mode, or request-auth-code + exchange-token for real integrations.

Option 2: Sandbox Token Set CASERA_SANDBOX_TOKEN for quick sandbox-only usage without logging in.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "casera": {
      "command": "npx",
      "args": ["-y", "@casera-tech/mcp-server"],
      "env": {
        "CASERA_API_URL": "https://api.casera.co.uk"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "casera": {
      "command": "npx",
      "args": ["-y", "@casera-tech/mcp-server"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "casera": {
      "command": "npx",
      "args": ["-y", "@casera-tech/mcp-server"]
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your project:

{
  "servers": {
    "casera": {
      "command": "npx",
      "args": ["-y", "@casera-tech/mcp-server"]
    }
  }
}

Getting Started

1. Register at the Casera Developer Portal
2. Configure the MCP server in your AI tool (see above)
3. Ask your agent to log you in — it will use developer-login + developer-verify-mfa
4. Start using sandbox or production tools

Usage Examples

Once configured, ask your AI agent things like:

• "Log me in to Casera" → triggers login + MFA flow
• "Show my authentication status" → checks tokens and session
• "List my client integrations" → shows OAuth integrations
• "Generate an auth code for a new client" → starts OAuth consent flow
• "Exchange this code for real tokens" → completes OAuth with real client
• "List the available Casera products"
• "Submit conveyancing details for my order and show me the available products"
• "Create a case and order with a conveyancing pack"
• "Generate a hot-link for the client"
• "Show me the webhook logs"
• "Help me implement the OAuth flow in TypeScript with Express"
• "Build a webhook handler in Python with signature verification"
• "Walk me through the full sandbox environment"

Use the built-in prompts for guided workflows:

• "Use the explore-sandbox prompt"
• "Use the implement-pack-ordering prompt"

Development

# Clone the repo
cd akita-mcp

# Install dependencies
npm install

# Run in development mode
npx tsx src/index.ts

# Build for distribution
npm run build

# Run the built version
node dist/index.js

License

MIT