Aoexl MCP Connector

Aoexl exposes a hosted MCP server at https://mcp.aoexl.com/mcp for creating signing requests, checking status, sending reminders, and managing templates from Claude Desktop, Cursor, and other MCP-compatible clients.

This folder now serves two roles:

the Cloudflare Worker that powers the hosted MCP endpoint
the publishable npm wrapper (aoexl-mcp) that lets users connect with npx

The main monorepo can remain private. If you want a public GitHub repo later, mirror only this folder (or a cleaned copy of it) into a small public repository such as github.com/aryansingh0203/aoexl-mcp.

What Users Install

The public package is intended to be used like this:

AOEXL_API_KEY=your_key_here npx -y aoexl-mcp

The package starts a local stdio proxy via mcp-remote and forwards requests to:

https://mcp.aoexl.com/mcp

Tools

create_signing_request
get_signing_request_status
list_signing_requests
send_signing_reminder
cancel_signing_request
duplicate_signing_request
reopen_signing_request
list_templates
create_request_from_template
get_audit_artifacts

Authentication Model

The hosted endpoint expects:

Authorization: Bearer <AOEXL_API_KEY>

Where AOEXL_API_KEY is a customer-owned key generated inside Aoexl Settings → MCP API Keys.

Internally the Worker resolves that API key to a user_id, then performs user-scoped operations against Supabase using the service-role key. This is what makes the connector multi-tenant and safe to distribute.

Local Development

Install dependencies from the repository root:

npm install

The Worker is configured in wrangler.jsonc and includes:

the MCP_OBJECT Durable Object binding required by McpAgent
a route for mcp.aoexl.com/*
the Aoexl app / Supabase URLs

Required Worker secrets:

npx wrangler secret put AOEXL_SUPABASE_ANON_KEY --cwd mcp-connector
npx wrangler secret put AOEXL_SERVICE_ROLE_KEY --cwd mcp-connector

Run locally:

npm run mcp:dev

or directly:

npm run dev --workspace=aoexl-mcp -- --ip 127.0.0.1 --port 8787

Health check:

curl http://127.0.0.1:8787/health

The /mcp endpoint is SSE/streamable HTTP, so a short test looks like:

curl --max-time 2 -i http://127.0.0.1:8787/mcp -H "Authorization: Bearer aok_live_example"

Customer Setup

Claude Desktop

{
  "mcpServers": {
    "aoexl-sign": {
      "command": "npx",
      "args": ["-y", "aoexl-mcp"],
      "env": {
        "AOEXL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Direct `mcp-remote` alternative

{
  "mcpServers": {
    "aoexl-sign": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.aoexl.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Publishing

npm package

This folder is prepared to publish aoexl-mcp publicly from npm without making the monorepo public.

Sanity check the package:

npm run package:check --workspace=aoexl-mcp

Publish from this folder:

cd mcp-connector
npm publish --access public

Smithery

Two viable paths:

recommended now: publish the hosted URL https://mcp.aoexl.com/mcp directly in Smithery
optional later: use the included smithery.yaml in a small public repo that contains only this connector

The smithery.yaml included here is ready for a repo/package-based install flow that injects AOEXL_API_KEY.

Official MCP Registry

This folder includes server.json, prepared for the current registry model:

mcpName in package.json
packages entry for aoexl-mcp
remotes entry for https://mcp.aoexl.com/mcp

Before publishing:

ensure the npm package is live
ensure https://mcp.aoexl.com/mcp is publicly reachable
ensure the repository URL in server.json points at a real public repo

Then publish with the current registry tooling, not the old PR flow.

Files Added For Distribution

bin/aoexl-mcp.cjs — npm-exposed stdio wrapper
smithery.yaml — Smithery config schema / start command
server.json — MCP Registry metadata

Notes

The public package name is aoexl-mcp.
The MCP Registry server name is io.github.aryansingh0203/aoexl-sign.
If you later decide to use a custom namespace instead of GitHub-based naming, update both server.json and package.json#mcpName.

Aoexl MCP Connector