Agent account

An inference account your agent can operate.

Create a provisional account for a human, get a scoped token, quote a call, pay with a prepaid key or x402, run the call, and hand the account back with a claim link. The human keeps control.

No browser requiredScoped 6-hour tokenx402 USDCMCPA2AQuote before spend
The loop

Open, fund, quote, call, hand off.

01

Open

Create a provisional account with an email and an idempotency key. The response contains a scoped token and a claim URL.

02

Fund

Return a Paystack checkout link for the human, charge a saved card after claim, or pay per call with x402 USDC.

03

Quote and call

Ask for a price before the call, then use the same account for OpenAI-compatible chat, embeddings, MCP and A2A.

04

Hand off

Give the human the claim link. They set a password and own the account. The agent token expires after six hours and can be refreshed after claim.

Create an account

One POST. Scoped token. Claim link.

POST https://api.fikraapi.co.ke/v1/agents/accounts Content-Type: application/json { "email": "[email protected]", "agent_name": "my-agent", "agent_version": "1.0", "idempotency_key": "one-per-request" } # returns account_id, token, token_expires_at, claim_url

Scopes

The delegated token is narrow. It cannot change the password, delete the account, reach admin, or enable auto-recharge.

keys:readkeys:writechat:writeusage:readbalance:readtopup:linktopup:charge

No signup credit on agent-created accounts. The agent must top up before chat works. That is deliberate: it stops credit farming and unsolicited accounts.

agents.json spec

Quote before spend

Know the price before the call.

The quote uses the same catalog and rate card as the call. It is the part an operator needs before allowing an agent to spend.

POST /v1/agent/quote { "model": "deepseek-v4.1-flash-1017", "messages": [{"role":"user","content":"Summarise this file"}], "max_tokens": 1024 }

What it returns

The estimated input tokens, the reserved output tokens, the model rate and the total price. Use it to decide whether the call fits the account balance before you send it.

Known limit today: agent chat is non-streaming and capped at 4,096 output tokens. Do not build a streaming agent loop on this endpoint yet.

x402

Pay per call. No account. No card.

Send a normal OpenAI-style body. If payment is missing, the API returns HTTP 402 with a machine-readable payment requirement. Sign the USDC transfer on Base and retry with the payment header.

# first attempt: no payment POST /v1/agent/chat/completions {"model":"deepseek-v4.1-flash-1017","messages":[...]} # 402 + PAYMENT-REQUIRED header # sign USDC on Base, then retry POST /v1/agent/chat/completions PAYMENT-SIGNATURE: <base64 payload>

Live today

  • ✓ USDC on Base mainnet
  • ✓ Chat and embeddings
  • ✓ Replay protection and facilitator settlement
  • ! Chat is non-streaming
  • ! Output capped at 4,096 tokens
  • ! One network and one asset
MCP

Mount the account in an MCP client.

Tools: fikra_list_models (free), fikra_quote (paid), fikra_chat (paid). The same account and rate card apply.

POST https://api.fikraapi.co.ke/v1/mcp Content-Type: application/json {"jsonrpc":"2.0","id":1,"method":"tools/list"}

What is live

JSON-RPC over HTTP. Paid tools are charged to the same wallet or x402 payment. There is no separate MCP billing product.

MCP and A2A docs ->

A2A

Agent-to-agent message/send.

The A2A route is a paid inference surface, not a directory listing. It shares the account, model catalog and price list.

POST https://api.fikraapi.co.ke/v1/a2a { "jsonrpc":"2.0","id":1, "method":"message/send", "params":{"message":{"role":"user","parts":[{"text":"Hello"}]}} }

Scope today

One method, non-streaming, same 4,096 output cap. The agent card is at /.well-known/agent-card.json. Do not claim a full A2A task lifecycle yet.

Truth

What is live and what is next.

Live today

  • ✓ Agent-created accounts and claim links
  • ✓ Scoped 6-hour tokens and refresh after claim
  • ✓ Quote endpoint
  • ✓ x402 chat and embeddings, USDC on Base
  • ✓ MCP tools and A2A message/send
  • ✓ Usage, balance and key management through the agent API

Next, not claimed as live

  • ! Streaming on agent surfaces
  • ! Per-agent budgets and hard spend caps
  • ! Quote-to-receipt reconciliation
  • ! TypeScript and Go SDKs
  • ! Multi-chain or multi-asset x402

These are on the roadmap page in the changelog when they ship. They are not sold today.