Expose your app's tools to agents

import { createToolServer, tool } from '@agentarea/tools';
import * as z from 'zod';

const server = createToolServer({
  name: 'orders',
  version: '1.0.0',
  auth: {
    bearer: process.env.AGENTAREA_TOOLS_BEARER!,
    secret: process.env.AGENTAREA_TOOLS_SECRET!,
    audience: process.env.AGENTAREA_INSTANCE_ID,
    issuer: 'agentarea',
  },
  tools: {
    import_sheet: tool({
      description: 'Import an order sheet',
      input: z.object({ url: z.string() }),
      execute: async ({ url }, ctx) => {
        await ctx.progress('Reading sheet', { progress: 1, total: 2 });
        // ctx.endUserId and ctx.metadata come from the signed token
        await ctx.progress('Saving rows', { progress: 2, total: 2 });
        return { text: 'Imported 23 rows.', data: { rows: 23 } };
      },
    }),
  },
});

curl -s -X POST "$AGENTAREA_URL/v1/workspaces/$WORKSPACE/mcp-server-instances/with-spec" \
  -H "Authorization: Bearer $AGENTAREA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "server": {
      "name": "Orders",
      "description": "Our order tools.",
      "remote_url": "https://app.example.com/api/mcp",
      "env_schema": [{"name": "Authorization", "description": "Static credential", "isSecret": true}]
    },
    "instance": {
      "name": "Orders",
      "json_spec": {
        "type": "url",
        "endpoint_url": "https://app.example.com/api/mcp",
        "headers": {"Authorization": "Bearer '"$AGENTAREA_TOOLS_BEARER"'"}
      },
      "context_secret": "'"$AGENTAREA_TOOLS_SECRET"'"
    }
  }' | jq '{id, signing: .json_spec.context_signing, status: .verification.status}'

curl -s -X POST "$AGENTAREA_URL/v1/workspaces/$WORKSPACE/agents/$AGENT_ID/tasks/sync" \
  -H "Authorization: Bearer $AGENTAREA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Import the sheet the user shared",
    "end_user_id": "user-42",
    "metadata": {"chatId": "c-9"}
  }'