Custom agents

nuez uses standard MCP over HTTP. Any MCP client library can connect to it.

Python (with mcp SDK)

import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client(
        "https://mcp.nuez.app",
        headers={"Authorization": "Bearer nz_sk_live_YOUR_KEY_HERE"},
    ) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()

            # Check balance
            result = await session.call_tool("nuez.balance", {})
            print(result)

            # Transfer
            result = await session.call_tool("nuez.transfer", {
                "amount": 1000,
                "destination": "alias.de.destino",
                "description": "Payment for services",
            })
            print(result)

asyncio.run(main())

TypeScript (with @modelcontextprotocol/sdk)

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://mcp.nuez.app"),
  {
    requestInit: {
      headers: { Authorization: "Bearer nz_sk_live_YOUR_KEY_HERE" },
    },
  }
);

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);

const balance = await client.callTool({ name: "nuez.balance", arguments: {} });
console.log(balance);

Tool reference

• nuez.transfer — parameters, return values, error codes
• nuez.balance
• nuez.list_transactions