Back to Home

Developer Tools

SDKs & Integration

Install in your language. Works with testnet and mainnet — just change the chain name.

No SDK Required

Obolo is HTTP-native. Any language, any HTTP client, any agent framework — just set three headers. SDKs are convenience wrappers, not requirements.

# No SDK needed — works with any HTTP client

# Step 1: Get payment instructions
curl https://gateflow-proxy.7crypto-jo.workers.dev/v1/weather-forecast

# Step 2: Send USDC on Base to the returned address
# (use your wallet, script, or agent framework)

# Step 3: Retry with payment proof
curl https://gateflow-proxy.7crypto-jo.workers.dev/v1/weather-forecast \
  -H "X-Payment-Hash: 0xYOUR_TX_HASH" \
  -H "X-Payment-Chain: base" \
  -H "X-Agent-Wallet: 0xYOUR_WALLET"

TypeScript SDK

@gateflow/sdk

TypeScript / JavaScript

Full-featured client for Node.js, Deno, and browser. Handles x402 payment flow, wallet management, and response parsing.

Install

npm install github:TheDataCryptoJo/GateFlow#master --workspace=packages/sdk

Quick Start

import { GateFlowClient } from '@gateflow/sdk';

const gf = new GateFlowClient({
  proxyUrl: 'https://gateflow-proxy.7crypto-jo.workers.dev',
  walletPrivateKey: process.env.WALLET_KEY,
  chain: 'base', // or 'base-sepolia' for testnet
});

const data = await gf.call('weather-forecast', {
  params: { q: 'London' },
});
View source on GitHub

Python SDK

gateflow

Python 3.9+

Pythonic interface for AI agent frameworks. Works with LangChain, CrewAI, AutoGen, and raw Python scripts.

Install

pip install git+https://github.com/TheDataCryptoJo/GateFlow.git#subdirectory=packages/python

Quick Start

from gateflow import GateFlowClient

gf = GateFlowClient(
    proxy_url="https://gateflow-proxy.7crypto-jo.workers.dev",
    wallet_key=os.environ["WALLET_KEY"],
    chain="base",  # or "base-sepolia" for testnet
)

data = gf.call("weather-forecast", params={"q": "London"})
View source on GitHub

LangChain Integration

@gateflow/langchain

TypeScript (LangChain)

Drop-in LangChain tool that lets agents discover and pay for Obolo APIs automatically within chains and agents.

Install

npm install github:TheDataCryptoJo/GateFlow#master --workspace=packages/langchain

Quick Start

import { GateFlowTool } from '@gateflow/langchain';

const weatherTool = new GateFlowTool({
  slug: 'weather-forecast',
  proxyUrl: 'https://gateflow-proxy.7crypto-jo.workers.dev',
  walletKey: process.env.WALLET_KEY,
});

// Use in a LangChain agent
const agent = createAgent({ tools: [weatherTool] });
View source on GitHub

MCP Server

@gateflow/mcp-server

TypeScript (MCP)

Model Context Protocol server. Claude, GPT, and other MCP-compatible agents can discover and use Obolo APIs natively.

Install

npm install github:TheDataCryptoJo/GateFlow#master --workspace=packages/mcp-server

Quick Start

// Add to your MCP config:
{
  "mcpServers": {
    "gateflow": {
      "command": "npx",
      "args": ["@gateflow/mcp-server"],
      "env": {
        "GATEFLOW_PROXY_URL": "https://gateflow-proxy.7crypto-jo.workers.dev",
        "WALLET_KEY": "your-wallet-private-key"
      }
    }
  }
}
View source on GitHub

Go SDK

gateflow

Go 1.21+

Lightweight Go client for high-performance agent applications. Minimal dependencies.

Install

go get github.com/TheDataCryptoJo/GateFlow/packages/go

Quick Start

import "github.com/TheDataCryptoJo/GateFlow/packages/go"

client := gateflow.NewClient(
    gateflow.WithProxy("https://gateflow-proxy.7crypto-jo.workers.dev"),
    gateflow.WithWallet(os.Getenv("WALLET_KEY")),
    gateflow.WithChain("base"),
)

data, err := client.Call("weather-forecast", map[string]string{
    "q": "London",
})
View source on GitHub

Rust SDK

gateflow

Rust

Type-safe Rust client with async/await support. Zero-copy response parsing.

Install

cargo add --git https://github.com/TheDataCryptoJo/GateFlow --path packages/sdk-rust

Quick Start

use gateflow::Client;

let client = Client::builder()
    .proxy_url("https://gateflow-proxy.7crypto-jo.workers.dev")
    .wallet_key(std::env::var("WALLET_KEY")?)
    .chain("base")
    .build()?;

let data = client.call("weather-forecast", &[("q", "London")]).await?;
View source on GitHub

Framework Integrations

Using CrewAI, AutoGen, LangChain, or MCP? We have drop-in tools for each framework.

View framework integrations →

Agent Discovery

Agents can discover Obolo programmatically — no human setup needed.

/.well-known/agent.json

A2A protocol agent card — compatible with Google ADK and any A2A-aware framework

/skill.md

Skill file — compatible with MCP, LangChain, CrewAI, OpenClaw/Moltbot

/llm.txt

Machine-readable API catalog — agents can parse and discover all available endpoints

/api/marketplace/catalog

JSON catalog API — full endpoint data with pricing, chains, and payment options