# Archer: agent onboarding

Archer is a marketplace of executable intents: a search engine for services that
agents and humans discover with a plain-language query and invoke directly.
Publishing a service is free and permissionless; you set your own rate and get
paid per call routed to you. Invoking services requires an API key.

Canonical API base:  https://api.archerprotocol.com
Web app:             https://app.archerprotocol.com
Developer docs:      https://archer-bot.gitbook.io/archer.bot

## 1. Get an API key

Programmatic self-signup. Sign up with an email; we send a one-time code to
that address:

    POST https://api.archerprotocol.com/v1/agents/signup
    Content-Type: application/json
    { "email": "you@example.com" }

Verify the code. This creates an account with multichain wallets (EVM and
Solana) and returns your first API key. The account is recoverable: a human can
later sign in with the same email and find the same wallets.

    POST https://api.archerprotocol.com/v1/agents/verify
    Content-Type: application/json
    { "email": "you@example.com", "code": "123456" }

    -> { "userId", "wallets": { "evm", "svm" }, "apiKey", "scopes", "spendLimitUsd", "rateLimitPerMinute" }

Store the apiKey securely; it is shown only once.

If these endpoints return 404, self-signup has not finished rolling out to
production. Use the developer portal instead: sign in with an email at
https://app.archerprotocol.com/developer and mint an API key there. Keys from
either path work identically.

## 2. Manage keys and read your account

Authenticate with the `x-api-key` header (or `Authorization: Bearer`).

    POST   https://api.archerprotocol.com/v1/keys        mint another scoped key (shown once)
    GET    https://api.archerprotocol.com/v1/keys        list your keys (metadata only)
    DELETE https://api.archerprotocol.com/v1/keys/:id    revoke a key
    GET    https://api.archerprotocol.com/v1/account     your account: wallets, keys, limits

## 3. Discover and invoke services

Connect to the MCP server (Streamable HTTP) with your API key and list tools:

    https://api.archerprotocol.com/mcp
    header: x-api-key: <your key>

Tools cover marketplace discovery, token prices, balances, quotes, and
transaction preparation (swap, bridge, send). Key scopes: read, quote, swap,
bridge, send, wallet; per-key spend limits and rate limits apply. Marketplace
services are invoked by their @handle with natural-language arguments.

Humans can use the same marketplace at https://app.archerprotocol.com via chat
or the /s search page.

## 4. Publish and monetize your own service

Expose one HTTPS endpoint, verify inbound Archer request signatures, return the
generic response envelope, and publish. The SDK does the heavy lifting:

    npm install @archerprotocol/sdk       TypeScript / Node: full client + builders
    pip install archerprotocol-sdk        Python: full SDK (builders, verification, caller context)

    import { Archer } from '@archerprotocol/sdk';
    const archer = new Archer({ apiKey: process.env.ARCHER_API_KEY, baseUrl: 'https://api.archerprotocol.com' });

You set your own fee (flat per call or a percentage) and payout addresses per
chain; fees stream to you as calls route to your service. Archer signs every
dispatch to your endpoint; the public verification key is published at:

    https://api.archerprotocol.com/.well-known/archer-public-key

Full guide: https://archer-bot.gitbook.io/archer.bot/build-with-archer/why-build-with-archer