Build with AI Front DoorIntegrate. Extend. Deploy.

# Exchange client credentials for an access token
curl -X POST https://ai.excopartners.com/api/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&scope=tools:invoke"

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

curl -X GET https://ai.excopartners.com/api/ai/tools/rest/my-tool \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."

curl https://ai.excopartners.com/.well-known/oauth-authorization-server

npm install @anthropic-ai/sdk @anthropic-ai/mcp-client

import Anthropic from "@anthropic-ai/sdk";
import { MCPClient } from "@anthropic-ai/mcp-client";

const AI_FRONT_DOOR_BASE = "https://ai.excopartners.com";

// Step 1: Obtain an OAuth 2.0 access token using client credentials.
async function getAccessToken(): Promise<string> {
  const res = await fetch(`${AI_FRONT_DOOR_BASE}/api/oauth/token`, {
    method: "POST",
    headers: { "Content-Type": "application/x-www-form-urlencoded" },
    body: new URLSearchParams({
      grant_type: "client_credentials",
      client_id: process.env.AIFD_CLIENT_ID!,
      client_secret: process.env.AIFD_CLIENT_SECRET!,
      scope: "tools:invoke",
    }),
  });
  if (!res.ok) throw new Error(`Token request failed: ${res.status}`);
  const data = await res.json();
  return data.access_token as string;
}

const accessToken = await getAccessToken();

// Step 2: Connect to the AI Front Door MCP server.
const mcpClient = new MCPClient({
  transport: "http",
  url: `${AI_FRONT_DOOR_BASE}/api/ai/tools/mcp/methods-mcp`,
  headers: {
    Authorization: `Bearer ${accessToken}`,
  },
});

await mcpClient.connect();

// Step 3: Fetch available tools from MCP.
const { tools } = await mcpClient.listTools();

// Step 4: Create the Anthropic client.
const anthropic = new Anthropic();

// Step 5: Run the agent loop.
async function runAgent(userMessage: string) {
  const messages: Anthropic.MessageParam[] = [
    { role: "user", content: userMessage },
  ];

  while (true) {
    const response = await anthropic.messages.create({
      model: "claude-sonnet-4-6",
      max_tokens: 4096,
      tools,
      messages,
    });

    if (response.stop_reason === "tool_use") {
      const toolResults: Anthropic.MessageParam = { role: "user", content: [] };

      for (const block of response.content) {
        if (block.type === "tool_use") {
          console.log(`Calling tool: ${block.name}`, block.input);
          const result = await mcpClient.callTool({
            name: block.name,
            arguments: block.input as Record<string, unknown>,
          });
          (toolResults.content as Anthropic.ToolResultBlockParam[]).push({
            type: "tool_result",
            tool_use_id: block.id,
            content: JSON.stringify(result),
          });
        }
      }

      messages.push({ role: "assistant", content: response.content });
      messages.push(toolResults);
      continue;
    }

    const textBlock = response.content.find((b) => b.type === "text");
    return textBlock?.type === "text" ? textBlock.text : "";
  }
}

const answer = await runAgent(
  "What are the eligibility requirements for unfair dismissal claims?"
);
console.log(answer);

await mcpClient.disconnect();

# .env
AIFD_CLIENT_ID=your-client-id
AIFD_CLIENT_SECRET=your-client-secret
ANTHROPIC_API_KEY=sk-ant-...

# First: get a token
TOKEN=$(curl -s -X POST https://ai.excopartners.com/api/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&scope=tools:invoke" \
  | jq -r '.access_token')

# Then: list knowledge resources
curl https://ai.excopartners.com/api/knowledge \
  -H "Authorization: Bearer $TOKEN"

curl https://ai.excopartners.com/api/knowledge/unfair-dismissal-eligibility \
  -H "Authorization: Bearer $TOKEN"

async function getAccessToken(clientId: string, clientSecret: string): Promise<string> {
  const res = await fetch("https://ai.excopartners.com/api/oauth/token", {
    method: "POST",
    headers: { "Content-Type": "application/x-www-form-urlencoded" },
    body: new URLSearchParams({
      grant_type: "client_credentials",
      client_id: clientId,
      client_secret: clientSecret,
      scope: "tools:invoke",
    }),
  });
  if (!res.ok) throw new Error(`Token request failed: ${res.status}`);
  const data = await res.json();
  return data.access_token as string;
}

async function getKnowledge(slug: string, token: string) {
  const res = await fetch(
    `https://ai.excopartners.com/api/knowledge/${slug}`,
    { headers: { Authorization: `Bearer ${token}` } }
  );
  if (!res.ok) throw new Error(`Knowledge fetch failed: ${res.status}`);
  return res.json();
}

const token = await getAccessToken(
  process.env.AIFD_CLIENT_ID!,
  process.env.AIFD_CLIENT_SECRET!
);
const item = await getKnowledge("unfair-dismissal-eligibility", token);
console.log(item.title, item.summary);

curl -X POST https://ai.excopartners.com/a2a/tasks \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Summarise the general protections process for a small business employer",
    "context": {
      "userRole": "employer",
      "employeeCount": 12
    }
  }'

{
  "taskId": "task_01J...",
  "status": "completed",
  "result": {
    "summary": "Under the general protections provisions...",
    "sources": [
      { "title": "General Protections Guide", "slug": "general-protections-guide" }
    ]
  }
}