MCP Server

NEXUS implements the Model Context Protocol, exposing your relationship data as a tool-calling interface for AI agents and LLM-powered applications.

How to Connect

The MCP server is accessible via two HTTP endpoints. Authenticate with a session cookie or Bearer token.

Approval Gates

Agent actions are scoped by token permissions and risk class. Reads run automatically within scope; writes are scope-checked and logged. Financial actions (spends_money — equity grants, budget, billing) and bulk outreach (bulk_send) always require human approval before executing. When a tool call requires approval, the response includes a pending approval ID. A human approves or rejects via the dashboard or the /v1/approvals/:id/approve endpoint.

Example

// List available tools
const response = await fetch(
  "https://api.nexusrelate.com/v1/mcp/tools/list",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    credentials: "include",
  }
);
const { tools } = await response.json();

// Call a tool
const result = await fetch(
  "https://api.nexusrelate.com/v1/mcp/tools/call",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    credentials: "include",
    body: JSON.stringify({
      tool: "records.create",
      arguments: {
        object_slug: "contact",
        attributes: {
          name: "Jane Smith",
          stage: "lead",
          source: "conference"
        }
      }
    })
  }
);