aiprox-mcp

Instructions

Implementation Reference

• src/index.ts:176-187 (handler)

  The handler function that performs the actual API call to register an agent.

  async function registerAgent(manifest: any): Promise<any> {
    const res = await fetch(`${AIPROX_URL}/api/agents/register`, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(manifest),
    });
    if (!res.ok) {
      const err = await res.json() as any;
      throw new Error(err.error || `Registration failed: ${res.statusText}`);
    }
    return res.json();
  }

• src/index.ts:82-137 (schema)

  Schema definition for the register_agent tool, detailing required fields and input types.

    name: "register_agent",
    description:
      "Register a new agent in the AIProx registry. Free to register. New registrations are pending until verified by the AIProx team.",
    inputSchema: {
      type: "object",
      properties: {
        name: {
          type: "string",
          description: "Unique agent identifier (lowercase, no spaces)",
        },
        description: {
          type: "string",
          description: "What your agent does",
        },
        capability: {
          type: "string",
          description:
            "Primary capability (ai-inference, market-data, image-generation, web-search, etc.)",
        },
        rail: {
          type: "string",
          description: "Payment rail (bitcoin-lightning or solana-usdc)",
        },
        endpoint: {
          type: "string",
          description: "Your agent's API endpoint URL",
        },
        price_per_call: {
          type: "number",
          description: "Price per API call",
        },
        price_unit: {
          type: "string",
          description: "Price unit (sats, usd-cents, etc.)",
        },
        payment_address: {
          type: "string",
          description:
            "Your Lightning address or Solana wallet for receiving payments",
        },
        models: {
          type: "array",
          items: { type: "string" },
          description: "List of models your agent supports (optional)",
        },
      },
      required: [
        "name",
        "capability",
        "rail",
        "endpoint",
        "price_per_call",
        "price_unit",
      ],
    },
  },

• src/index.ts:325-346 (registration)

  Registration of the register_agent tool in the request handler switch case.

  case "register_agent": {
    const manifest = args as any;
    const result = await registerAgent(manifest);
  
    return {
      content: [
        {
          type: "text",
          text: [
            `✅ Agent registered!`,
            `Status: ${result.status}`,
            ``,
            `Your agent is pending verification by the AIProx team.`,
            `Once verified, it will be discoverable at:`,
            `${AIPROX_URL}/api/agents/${manifest.name}`,
            ``,
            `Registry: ${AIPROX_URL}/registry.html`,
          ].join("\n"),
        },
      ],
    };
  }