agenttools

x402 client for the MCF Agentic gateway. 187 pay-per-request AI agent tool endpoints.

Payments in USDC on Base L2 via the x402 protocol.

Install

npm install agenttools

Quick Start

import { AgentTools } from "agenttools";

const tools = new AgentTools("https://gateway.mcfagentic.com");

// Generate leads with the full AI pipeline ($1.00/call)
const leads = await tools.pipeline.generateLeads({
  industry: "plumbing",
  location: "Dallas, TX",
  count: 3,
  include_outreach: true,
});

// CRM operations ($0.001-$0.05/call)
const accounts = await tools.crm.listAccounts();
await tools.crm.createLead({ name: "Acme Corp", email: "[email protected]" });

// AI email classification ($0.05/call)
const result = await tools.email.classify({
  subject: "Re: Your proposal",
  body: "Looks great, let's schedule a call.",
});

// Send email ($0.05/call)
await tools.email.send({
  to: "[email protected]",
  subject: "Follow-up",
  html: "<p>Thanks for your interest!</p>",
});

Tools

| Tool | Endpoints | Price Range | Description | |------|-----------|-------------|-------------| | Pipeline | 3 | $0.25-$1.00 | Autonomous lead gen — one call, full research + outreach | | CRM | 21 | $0.001-$0.05 | Accounts, leads, deals, contacts, pipelines, work orders | | Email | 13 | $0.001-$0.10 | Send, classify, AI reply, entity extraction | | Scheduling | 9 | $0.001-$0.01 | Staff, appointments, availability, events | | Marketing | 11 | $0.001-$0.05 | Prospects, campaigns, outreach, solutions | | Ads | 23 | $0.001-$0.10 | Campaigns, A/B tests, audits, AI optimization | | UGC | 32 | $0.001-$0.25 | AI video pipeline, TikTok, YouTube, media library | | Accounting | 16 | $0.001-$0.10 | Invoices, expenses, job costs, P&L reports | | Analytics | 15 | $0.001-$0.05 | Events, funnels, cohorts, attribution, revenue | | Notifications | 4 | $0.001-$0.05 | Templates, send (email/SMS), delivery log | | Consulting | 31 | $0.001-$0.25 | AI proposals, client mgmt, transcription, scoring |

Payment

All endpoints use x402 (HTTP 402). Send a request without payment to get pricing info:

try {
  await tools.pipeline.generateLeads({ industry: "hvac", location: "Austin, TX" });
} catch (err) {
  if (err.name === "X402PaymentRequired") {
    console.log(err.pricing); // { price: "$1.00", network: "eip155:8453", ... }
  }
}

For automatic payments, use an x402-compatible HTTP client like @x402/fetch.

Gateway

Default: https://gateway.mcfagentic.com

GitHub: Cameron48/agenttools

License

MIT