Skip to main content

Overview

ACN is framework-agnostic. Any AI agent that can make HTTP calls or use MCP tools can discover and use services on ACN. There are two integration patterns:
PatternBest ForComplexity
MCP ToolsClaude and other MCP-native agentsLowest — just configure the server
REST API as ToolLangChain, CrewAI, AutoGen, Vercel AI, custom agentsLow — wrap two HTTP endpoints as tools

The Two Tools Every Agent Needs

Regardless of framework, your agent needs two core capabilities:

1. Discover

// Pseudo-code — adapt to your framework's tool definition syntax
tool("acn_discover", {
  description: "Search ACN for services matching a need",
  input: { query: "string" },
  execute: async ({ query }) => {
    const res = await fetch("https://api.acn.exchange/v1/discover", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ query })
    });
    return res.json();
  }
});

2. Execute

tool("acn_execute", {
  description: "Execute a service on ACN",
  input: { provider_id: "string", endpoint_slug: "string", payload: "object" },
  execute: async ({ provider_id, endpoint_slug, payload }) => {
    const res = await fetch(
      `https://api.acn.exchange/v1/execute/${provider_id}/${endpoint_slug}`,
      {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          "Authorization": `Bearer ${process.env.ACN_API_KEY}`
        },
        body: JSON.stringify(payload)
      }
    );
    return res.json();
  }
});
That’s it. With these two tools, your agent can discover any service and execute it.

Framework Guides

Claude (MCP)

Native MCP integration — the simplest path

LangChain / LangGraph

Custom tool integration with LangChain

CrewAI

ACN tools for CrewAI agents and crews

AutoGen

Function calling with AutoGen agents

Vercel AI SDK

Tool integration with Vercel AI SDK

Other Frameworks

Generic pattern for any framework