ActionGate Examples

ActionGate Examples

Integration examples for ActionGate — an x402 + Stripe payment proxy for REST APIs and MCP tools.

ActionGate ships with three built-in safety tools as its default example config:

Payment Options

ActionGate supports two payment methods:

• Free tier — no signup or API key needed. Rate-limited per tool.
• x402 micropayments — pay-per-call with USDC on Base. No account required.
• Stripe-funded API credits — buy prepaid credits at /billing, receive an ag_live_... API key, and calls deduct from your balance.

Framework Examples

SDKs

TypeScript

npm install actiongate-sdk

import { ActionGateClient } from "@actiongate/sdk";

const client = new ActionGateClient({
  baseUrl: "https://api.actiongate.xyz",
  apiKey: process.env.ACTIONGATE_API_KEY, // optional — omit for free tier or x402
});

const result = await client.policyGate({
  actor: { actor_id: "agent_ops_02" },
  action: {
    action_type: "transfer",
    network: "base",
    asset_symbol: "USDC",
    amount: "150000",
    target: "0x1111111111111111111111111111111111111111",
  },
  policy: { policy_id: "treasury_default_v1" },
});

Python

pip install actiongate-sdk

from actiongate_sdk import ActionGateClient

client = ActionGateClient(
    base_url="https://api.actiongate.xyz",
    api_key=None,  # optional — omit for free tier or x402
)

result = client.policy_gate({
    "actor": {"actor_id": "agent_ops_02"},
    "action": {
        "action_type": "transfer",
        "network": "base",
        "asset_symbol": "USDC",
        "amount": "150000",
        "target": "0x1111111111111111111111111111111111111111",
    },
    "policy": {"policy_id": "treasury_default_v1"},
})

MCP Endpoint

All examples connect to the same endpoint:

https://api.actiongate.xyz/mcp

ActionGate uses Streamable HTTP transport. No authentication required for the free tier.

Remote MCP (any MCP-compatible client)

{
  "mcpServers": {
    "actiongate": {
      "url": "https://api.actiongate.xyz/mcp"
    }
  }
}

Local stdio package

npm install -g actiongate-mcp

{
  "mcpServers": {
    "actiongate": {
      "command": "npx",
      "args": ["actiongate-mcp"],
      "env": {
        "PAYTO_ADDRESS": "0xYourWallet",
        "ACTIONGATE_BASE_URL": "https://api.actiongate.xyz"
      }
    }
  }
}

Registry namespace

xyz.actiongate.api/actiongate

MCP server quality

This public examples repo includes glama.json metadata for Glama indexing of the hosted ActionGate MCP endpoint. The production ActionGate implementation is maintained separately; this repo documents client integrations, proxy configuration, the hosted endpoint, maintainers, MIT license, tool annotations, input schemas, output schemas, and the intended pre-execution flow:

1. Call risk_score to classify the proposed action.
2. Call simulate to estimate cost, failure probability, and side effects.
3. Call policy_gate to return a final policy decision before execution.

All three default MCP tools are pre-execution checks. They do not submit transactions, move funds, or mutate policy packs.

BYO API (Proxy Config)

ActionGate can proxy any upstream API. Operators define tools in a proxy-config.json and ActionGate exposes them over REST (/proxy/:toolName) and MCP (/mcp) with x402 or Stripe billing attached.

See docs/proxy-config-guide.md for the full schema and walkthrough.

Quick example:

{
  "serviceName": "My Paid API",
  "serviceDescription": "ActionGate deployment for my upstream APIs.",
  "defaultFreeTierCallsPerDay": 50,
  "tools": [
    {
      "name": "summarize",
      "description": "Summarize long text with my upstream model.",
      "targetUrl": "https://example.com/v1/summarize",
      "method": "POST",
      "priceUsd": "0.25",
      "freeTierLimit": 5,
      "inputSchema": {
        "type": "object",
        "properties": { "text": { "type": "string" } },
        "required": ["text"]
      }
    }
  ]
}

Pricing

The bundled safety tools use the following pricing:

Custom proxy deployments set their own pricing per tool in proxy-config.json.

Links

• ActionGate API
• Documentation
• Pricing
• OpenAPI Spec
• Proxy Config Guide
• Server Card
• Discovery JSON
• Billing Portal

License

MIT. See LICENSE.