Connect an agent

{
  "name": "research-agent-prod",
  "status": "active",
  "mode": "platform",
  "tools": { "enable": ["tavily/search", "firecrawl/scrape"] },
  "pricing": null,
  "maxCreditsPerCall": "250",
  "expiresAt": "2026-09-17T18:04:11.000Z",
  "mcp": {
    "url": "https://api.paywithlocus.com/api/credits/mcp",
    "headers": { "Authorization": "Bearer lcac_…" }
  },
  "credential": "lcac_…"
}

npx skills add https://paywithlocus.com

{
  "pricing": {
    "markupBps": 500,
    "flatMarkupUsdc": "0.001",
    "endpoints": {
      "tavily/search": { "markupBps": 1000, "flatMarkupUsdc": "0" }
    }
  }
}

const agent = new LocusCredits(process.env.LOCUS_AGENT_CONNECTION!, {
  baseUrl: "https://api.paywithlocus.com",
});

await agent.callJson(
  "tavily/search",
  { query: "agent payments" },
  { loopId: "run_42" },
);

https://api.paywithlocus.com/api/credits/mcp

curl "https://api.paywithlocus.com/api/credits/mcp/oauth/authorize/public-context?request=$LOCUS_MCP_REQUEST"

LOCUS_OAUTH_CLIENT_ID=$(curl -sf -X POST "https://api.paywithlocus.com/api/credits/mcp/oauth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "my-headless-agent",
    "grant_types": ["urn:ietf:params:oauth:grant-type:device_code", "refresh_token"],
    "token_endpoint_auth_method": "none"
  }' | jq -er .client_id)

curl -X POST "https://api.paywithlocus.com/api/credits/mcp/oauth/device_authorization" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "client_id=$LOCUS_OAUTH_CLIENT_ID" \
  --data-urlencode "resource=https://api.paywithlocus.com/api/credits/mcp" \
  --data-urlencode "scope=mcp:read mcp:execute offline_access"

{
  "name": "cancel_cost_approval",
  "arguments": {
    "approval_token": "...approval_token from estimate_cost..."
  }
}

import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";
import { randomUUID } from "node:crypto";
import {
  addCreditAmounts,
  parseMcpToolResult,
  prepareMcpResultForSynthesis,
  selectSynthesisAnswer,
} from "@withlocus/credits";

const tool = parseMcpToolResult(await mcp.callTool(request));
if (!tool.ok) throw new Error(tool.message);

const prepared = prepareMcpResultForSynthesis(tool, {
  maxItems: 10,
  maxContextChars: 12_000,
});

await results.put({ raw: prepared.raw, artifact: prepared.artifact });

let synthesisCharge = "0";
const meteredFetch: typeof fetch = async (input, init) => {
  const response = await fetch(input, init);
  synthesisCharge = response.headers.get("x-locus-credits-charged") ?? "0";
  return response;
};
const locusInference = createOpenAI({
  apiKey: process.env.LOCUS_AGENT_CONNECTION!,
  baseURL: "https://api.paywithlocus.com/api/wrapped/credits/v1",
  headers: { "Idempotency-Key": randomUUID() },
  fetch: meteredFetch,
});

const synthesis = await generateText({
  model: locusInference.chat("gpt-4o-mini"),
  system: "Answer only from the supplied evidence.",
  prompt: `Question:\n${question}\n\nEvidence:\n${prepared.modelContext}`,
  tools: undefined,
  toolChoice: "none",
  maxOutputTokens: 700,
});

const answer = selectSynthesisAnswer(
  {
    text: synthesis.text,
    finishReason: synthesis.finishReason,
    outputTokens: synthesis.usage.outputTokens,
  },
  prepared,
);

const totalCharge = addCreditAmounts(
  tool.billing.creditsCharged ?? "0",
  synthesisCharge,
);

const active = await locus.agentConnections.list();
const current = await locus.agentConnections.get(connectionId);

const rotated = await locus.agentConnections.rotate(connectionId);
await replaceSecret(rotated.credential); // old credential stops working

await locus.agentConnections.revoke(connectionId); // immediate and permanent

curl -i -X POST "https://api.paywithlocus.com/api/credits/mcp" \
  -H "Authorization: Bearer $LOCUS_AGENT_CONNECTION" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": "check-1",
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": { "name": "connection-check", "version": "1.0.0" }
    }
  }'