Connect Widget

Your App                    RouteMCP                   Provider
  │                            │                           │
  │  POST /connect/token       │                           │
  │  (with endUserId)          │                           │
  │ ──────────────────────────>│                           │
  │  { token: "ct_..." }      │                           │
  │ <──────────────────────────│                           │
  │                            │                           │
  │  Open Connect widget       │                           │
  │  with token                │                           │
  │ ─────────────────────>     │                           │
  │                            │   OAuth / Credentials     │
  │                            │ ────────────────────────> │
  │                            │   Access granted          │
  │                            │ <──────────────────────── │
  │  onSuccess callback        │                           │
  │ <─────────────────────     │                           │
  │                            │                           │
  │  GET /contacts?provider=   │                           │
  │ ──────────────────────────>│  Fetch from provider      │
  │  Unified data              │ ────────────────────────> │
  │ <──────────────────────────│ <──────────────────────── │

curl -X POST https://api.routemcp.io/api/v1/connect/token \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "endUserId": "user-123",
    "endUserDisplayName": "Jane Doe"
  }'

{
  "success": true,
  "data": {
    "token": "ct_abc123...",
    "expiresAt": "2026-03-09T15:00:00.000Z"
  }
}

npm install @routemcp/connect-sdk
# or
pnpm add @routemcp/connect-sdk

import { RouteMCPConnect } from '@routemcp/connect-sdk';

RouteMCPConnect.open({
  token: "ct_abc123...",
  onSuccess: (connection) => {
    console.log("Connected:", connection.provider);
    // Now you can fetch data for this user
  },
  onError: (error) => {
    console.error("Connection failed:", error);
  },
  onClose: () => {
    console.log("Widget closed");
  },
});

import { ConnectButton } from '@routemcp/connect-sdk/react';

function MyConnectButton({ token }: { token: string }) {
  return (
    <ConnectButton
      token={token}
      onSuccess={(connection) => {
        console.log("Connected:", connection.provider);
        // Now you can fetch data for this user
      }}
      onError={(error) => console.error("Connection failed:", error)}
      onClose={() => console.log("Widget closed")}
    />
  );
}

<script src="https://connect.routemcp.com/sdk.js"></script>
<script>
  RouteMCP.connect({
    token: "ct_abc123...",
    onSuccess: (connection) => {
      console.log("Connected:", connection.provider);
    },
    onError: (error) => {
      console.error("Connection failed:", error.message);
    },
    onClose: () => {
      console.log("Widget closed");
    }
  });
</script>

curl https://api.routemcp.io/api/v1/crm/contact?provider=hubspot \
  -H "Authorization: Bearer sk_live_your_api_key"