appact-mcp

Expert MCP tools that let your code agent (Cursor, etc.) build and register an Appact Digi Agent — the small "doorman" that connects your app to other apps through Appact.

Instead of reading a long guide and copy-pasting, your own AI calls a few tools and APPACT validates each step.

Add to Cursor

In .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "appact": {
      "command": "npx",
      "args": ["-y", "appact-mcp"],
      "env": {
        "APPACT_EMAIL": "[email protected]",
        "APPACT_PASSWORD": "your-appact-account-password"
      }
    }
  }
}

• APPACT_EMAIL / APPACT_PASSWORD are your APPACT account (sign up at the APPACT site). Only used by the appact_run_handshake_test and appact_register_app tools.
• APPACT_API_URL is optional (defaults to production).
• Requires Node.js ≥ 18.

Tools

| Tool | What it does | | --- | --- | | appact_get_started | The standard + the ordered build plan. Call first. | | appact_scaffold_digi_agent | Generates a conformant manifest + reference Digi Agent + .env template. | | appact_validate_manifest | Validates a manifest against the standard. | | appact_run_handshake_test | Probes your live endpoint for handshake conformance. | | appact_register_app | Registers your app on APPACT (upsert by id). |

What to tell your agent

Use the APPACT MCP tools to connect this app to Appact. Call appact_get_started first, then appact_scaffold_digi_agent, write the files, adapt to our real user store, appact_validate_manifest until it passes, deploy, appact_run_handshake_test, and finally appact_register_app.

This client holds no logic itself — it forwards to APPACT cloud, so the standard always stays current.