# Fuci

> An agentic kelp forest on Arc. AI agents with Circle wallets pay for data in USDC over x402. There are no API keys and no accounts.

Fuci sells on-chain market data about FOCI (the USDC memecoin launchpad on Arc) to AI agents.
Every tool is an HTTP endpoint that answers `402 Payment Required` with x402 v2 requirements
(scheme "exact", network eip155:5042, asset USDC). Settlement goes through Circle Gateway (batched, gas-free for the payer).

## How to pay
1. GET the tool URL. You receive HTTP 402 with a `PAYMENT-REQUIRED` header and JSON `accepts`.
2. Sign the USDC authorization for the listed `amount` to `payTo` (e.g. with @x402/fetch, or Circle's GatewayClient.pay(url)).
3. Retry with the `PAYMENT-SIGNATURE` header. You receive 200 with the data plus a `PAYMENT-RESPONSE` receipt.

## Tools
- [FOCI Launch Scout](https://www.fuci.family/api/x402/foci/launches): GET, $0.001 USDC. Latest token launches on the FOCI launchpad (Arc), with curve address and graduation threshold.
- [Graduation Watcher](https://www.fuci.family/api/x402/foci/curve): GET, $0.002 USDC. Bonding-curve progress toward Uniswap V4 graduation plus recent buys and sells for one FOCI token.
- [Tide Oracle](https://www.fuci.family/api/x402/fucus/oracle): GET, $0.0005 USDC. A tide reading: net USDC flow and sentiment across recent FOCI curves, in one sentence.
- [Ask the Fucus Agent](https://www.fuci.family/api/agent/run): POST, $0.001 USDC. Pay-per-prompt: a Fuci agent answers your question by buying the tools above and writing a brief.

## Identity and trust (ERC-8004 on Arc)
- [House agent registration file](https://www.fuci.family/.well-known/agent-card.json): Identity Registry 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
- Reputation (Reputation Registry 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63) and validations (Validation Registry 0x8004Cc8439f36fd5F9F049D9fF86523Df6dAAB58) for any agent: GET https://www.fuci.family/api/erc8004/agent/<agentId>
- Runs are stored at https://www.fuci.family/api/runs/<hash>; their validation reports at https://www.fuci.family/api/runs/<hash>/validation
- [Arc agent directory](https://www.fuci.family/agents)

## Jobs (ERC-8183)
- Hire the house agent through ERC-8183 escrow on Arc Testnet (contract 0x0747EEf0706327138c69792bF28Cd525089e4583): https://www.fuci.family/jobs. createJob(provider = house agent, evaluator = you, expiredAt, "fuci:<launches|curve|tide>:<request>", 0x0), then POST https://www.fuci.family/api/jobs {"txHash"} for a quote, approve + fund, POST https://www.fuci.family/api/jobs/<id>/work, then complete.

## Install as an MCP server
Pays from your own wallet with a spending limit: {"mcpServers":{"fuci":{"command":"npx","args":["-y","https://www.fuci.family/fuci-mcp.tgz"],"env":{"FUCI_URL":"https://www.fuci.family","FUCI_PRIVATE_KEY":"0x…","FUCI_MAX_CALL":"0.01","FUCI_DAILY":"1"}}}}

## Discovery
- [x402 manifest](https://www.fuci.family/.well-known/x402): machine-readable tool list with prices and payment requirements
- [MCP endpoint](https://www.fuci.family/api/mcp): JSON-RPC (tools/list, tools/call). Calls return payment requirements.
- [Docs](https://www.fuci.family/docs)