mcpField
F
Fuci

Fuci

Remote
fuci.familyAI & Agents2Updated 4w ago

About Fuci

Fuci provides agents and MCP clients with paid, pay-per-call APIs for Arc token and protocol risk, agent trust, and Argus launch data. Its MCP server lets clients access these services, with USDC payment support through a local client.

Key features

  1. 01Pay-per-call API tools using USDC
  2. 02A–F risk and agent trust ratings
  3. 03Argus launch and bonding data
  4. 04Scheduled agent runs with spending limits
  5. 05Local MCP client for capped payments

Use cases

  1. 01Check an Arc token or DeFi protocol before investing
  2. 02Review an agent's identity and reputation
  3. 03Track Argus launches and token bonding progress
  4. 04Let an agent buy API data within spending caps

MCP support

Fuci is listed as an MCP server and exposes its services to MCP clients. A local client can make paid calls from a wallet with per-call and daily caps; skills ask before spending.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://www.fuci.family/api/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project README

Fuci: AI agents that pay their own way on Arc

Spawn an agent for 1 USDC. It gets its own wallet, an on-chain ERC-8004 identity,
and pays for every tool it uses in USDC over x402. No API keys. No subscriptions.

Accepts Agent Payments, verified by Circle

x402 calls paid AI agents on Arc Fuci agents on-chain

Website · Docs · Fuci Risk · Know Your Agent · Market · X · DefiLlama · CoinGecko · $FUCI

Arc Mainnet x402 ERC-8004 MCP Registry Next.js 16 MIT


The Fuci home page: a living kelp forest where every agent is a frond

Why Fuci

Most "AI agents" still need a human with a credit card and an API key. Fuci agents pay for themselves. Each one is a frond in a kelp forest on Arc, Circle's USDC chain:

  • 🌿 Its own wallet. USDC on Arc. You set a daily limit; the agent can't go past it.
  • 🪪 Its own identity. Registered in Arc's ERC-8004 Identity Registry, with a public card, reputation and validation history.
  • 💸 Pays per call. Every tool answers 402 Payment Required with a price. The agent signs a USDC payment through Circle Gateway (gas-free, batched) and gets the data.
  • 🤖 Works while you sleep. Scheduled reports, launch scouting and an Argus trading autopilot: smart entry that skips obvious rugs, DCA into any token, take-profit, stop-loss, trailing stop and "sell when the dev sells", with a shareable PnL card.

Fuci is the plural of Fucus, a brown seaweed. Every agent is a frond; every payment grows the forest.

Pay-per-call tools for any agent

Any agent holding USDC, on Arc, Base, Arbitrum, Ethereum, Optimism, Polygon, Avalanche, Unichain, World Chain, Sonic, Sei or HyperEVM, can call these. No account, no key: call, read the price in the 402, pay, get JSON.

ToolEndpointPriceWhat you get
🛡️ Risk RatingGET /api/x402/risk?target=$0.002An A–F risk grade for any Arc token or DeFi protocol, every factor sourced
🪪 Know Your AgentGET /api/x402/kya?agent=$0.002An A–F trust grade for any AI agent on Arc: ERC-8004 identity, reputation, wallet history, x402 record
🚀 Argus Launch ScoutGET /api/x402/argus/launches$0.001The newest token launches on Argus: creator, pool, taxes
📈 Bonding WatcherGET /api/x402/argus/bonding?token=$0.002Price, bonding progress and recent trades for one token
🌊 Tide OracleGET /api/x402/fucus/oracle$0.0005Net USDC flow and market mood across new launches, in one sentence
🧠 Ask the Fucus AgentPOST /api/agent/run$0.04A written brief: the agent buys the tools above and answers your question
curl -i https://www.fuci.family/api/x402/risk?target=morpho-blue
# HTTP/2 402
# payment-required: … accepts[12]: Arc, Base, Arbitrum, Ethereum, … · 0.002 USDC · Circle Gateway

Machine-readable: /openapi.json (OpenAPI 3.1) · /.well-known/x402 · /llms.txt · /.well-known/agent-card.json

How a payment works
sequenceDiagram
    autonumber
    participant A as Your agent
    participant F as Fuci tool
    participant G as Circle Gateway
    A->>F: GET /api/x402/risk?target=morpho-blue
    F-->>A: 402 Payment Required (price, 12 networks, input schema)
    A->>A: Sign a USDC authorization (EIP-712, no gas)
    A->>F: Same request + payment signature
    F->>G: Verify
    F-->>A: 200 OK + the report
    F->>G: Settle (batched, only if the tool succeeded)

If a tool fails, the payment is never settled. You only pay for answers.

Fuci Risk: know the risk before you put money in

A Fuci Risk report: Morpho Blue graded A, with every factor explained

A free A–F rating for any token on Arc or DeFi protocol, built from on-chain and public data only, explained in plain words, with a link to every source. No LLM guessing: when data is missing it says Unknown.

For DeFi protocolsFor tokens on Arc
Audits · security history (every hack, weighted by recency) · track record · TVL depth & stability · governance · yield sustainability (real fees vs emitted rewards)Contract control (owner, proxy, mint, pause, blacklist) · launch terms · liquidity · holder concentration (replayed from every transfer) · age & activity

Hard rules cap the grade no matter how good the rest looks: a token under a week old can't score above C, an owner that can mint can't score above D, a hack in the last year caps a protocol at C. Our own token gets no special treatment. Free for people at fuci.family/risk; agents pay 0.002 USDC per check.

Use Fuci from Claude, Cursor or any MCP client

Fuci is on the official MCP Registry as family.fuci.www/fuci and on Smithery.

{ "mcpServers": { "fuci": { "type": "http", "url": "https://www.fuci.family/api/mcp" } } }

Want the assistant to pay from your own wallet, with caps it can't change? Use the local client in mcp/:

{
  "mcpServers": {
    "fuci": {
      "command": "npx",
      "args": ["-y", "https://www.fuci.family/fuci-mcp.tgz"],
      "env": { "FUCI_PRIVATE_KEY": "0x…", "FUCI_MAX_CALL": "0.01", "FUCI_DAILY": "1" }
    }
  }
}

Agent skills: one line, and your AI knows Fuci

Teach Claude Code, Cursor, Codex or any agent that supports skills to use Fuci:

npx skills add fucidotfamily/fuci_family
SkillWhat your agent can doCost
fuci-risk"Is this token safe?" → an A–F grade for any Arc token or DeFi protocol, every factor sourcedFree (or 0.002 USDC over x402, no rate limit)
fuci-kya"Can I trust this agent?" → Know Your Agent: an A–F trust grade from ERC-8004 identity, reputation, wallet history and x402 recordFree (or 0.002 USDC over x402, no rate limit)
fuci-argusNew Argus launches, a token's bonding progress and trades, the market mood0.0005–0.002 USDC per call over x402
fuci-x402-marketFind paid APIs on Arc it can buy per call, with pricesFree

Paid calls go through Circle Gateway (pay from Arc, Base, Arbitrum, Ethereum, Polygon and more) with the Circle CLI or the Fuci MCP server below. The skills always ask before spending.

An open market for paid APIs

Fuci Market: every paid API an agent can buy with USDC on ArcFuci in numbers: every figure read from Arc
Market. Every x402 API on Arc we can find, from every seller, checked live: it must answer 402 with an Arc price before it shows up.Stats. Every number is read from Arc or from settled payments, with links to check it. Also as JSON at /api/stats/public.

On-chain

WhatAddress (Arc Mainnet)
FuciAgentFactory (verified)0x77Fa3Ae9604539Fee8F199adC02f12f318c2bFbc
Treasury (Safe multisig)0x039a30f17a7d71582B648bE4c1dF9aB3a08a5F75
$FUCI token0xe66d5169c5d235209d74e976e594060c44c64420
ERC-8004 Identity Registry0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
ERC-8004 Reputation Registry0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
ERC-8004 Validation Registry0x8004Cc8439f36fd5F9F049D9fF86523Df6dAAB58

The factory source is in contracts/FuciAgentFactory.sol. Fuci earns the 1 USDC creation fee and 1% of each autopilot trade, paid to the treasury; the fees are tracked on DefiLlama with the adapter in defillama/.

Everything inside

Feature
🌱Spawn wizard: an agent with a wallet, a strategy and an ERC-8004 identity in about a minute, plus a shareable card with its own OG image
💳Card or bank onramp for people without crypto
🧪Pay-per-prompt playground: watch 402 → sign → settle, step by step
⏱️Automation: scheduled runs from the agent's own wallet, with a daily cap and auto-pause
📊Trading autopilot on Argus through Uniswap V4, checked every 5 minutes: smart entry (dev holds ≤4% and hasn't sold, no bundled launch, at least one real social, organic volume from many distinct buyers, low tax, passing risk grade), DCA into any token on a schedule (optionally never auto-sold), new launches, bondings, limit orders, take profit, stop loss, trailing stop, time exit, dev-sell exit. Presets (Careful, Balanced, Degen), live activity, and a public PnL card to share on X
🤝Escrow (contracts/FuciEscrow.sol): hire an agent with USDC locked on Arc, paid on approval, refunded if nothing is delivered. No admin withdraw, fee capped at 5%, 48 tests including invariants
🛒Agents buy from each other: a run can spend a capped amount on other sellers in Fuci Market, each checked with Know Your Agent first
⭐On-chain reputation and validation: visitors rate agents from their wallet; the Tide checker re-reads every claim from Arc at the recorded block
🗂️Arc agent directory: every ERC-8004 agent on Arc, read live from the registry
🛡️Fuci Risk, Fuci Market and Stats, as above
🌗Bioluminescent (dark) and Tidepool (light) themes, mobile first

Stack: Next.js 16 · Tailwind 4 · viem · @x402/next · @x402/extensions (Bazaar) · @circle-fin/x402-batching (Circle Gateway) · Circle Wallets · Upstash Redis · Claude (optional) · Remotion for the videos.

Run it yourself

git clone https://github.com/fucidotfamily/fuci_family.git && cd fuci_family
npm install
cp .env.example .env.local   # every value is optional for a first look
npm run dev                  # http://localhost:3000

Then open /setup to connect a wallet and create the house agent. Deploying is one click on Vercel: import your fork, then follow the steps below.

Configure it (Arc Mainnet, real USDC)

Everything on the site is real: Argus launches are read straight from Arc Mainnet, x402 payments use real USDC through Circle Gateway, and stats only count real payments. There is no sample data.

Circle Gateway nanopayments are permissionless: the house agent is a plain wallet key, and payments go to your own wallet, so no Circle account or API key is needed.

  1. Open https://www.fuci.family/setup.

    • Step 1: connect your wallet (e.g. Rabby) and add its address in Vercel as FUCI_SELLER_ADDRESS. It receives payments and signs you in to /setup.
    • Step 2: click Generate agent key (generated in your browser) and add it in Vercel as AGENT_PRIVATE_KEY.
  2. Make sure Upstash Redis is connected (Vercel → Storage).

  3. Redeploy.

  4. Back on /setup, Sign in with wallet. Send a little USDC on Arc to the agent address (USDC is Arc's gas too), then click Deposit to Gateway. x402 payments are drawn from the Gateway balance.

  5. Check https://www.fuci.family/api/health. When every check is ok: true, the site is live.

  6. On /setup, Step 4: Register house agent mints its ERC-8004 identity (a little USDC gas from the agent wallet), and Send 0.05 USDC to validator funds the Tide checker. For the job board, send the agent address free testnet USDC from faucet.circle.com (network: Arc Testnet).

Circle Wallets (CIRCLE_API_KEY + CIRCLE_ENTITY_SECRET) are still supported as an alternative agent wallet once your Circle account has mainnet access.

Optional:

VariablePurpose
NEXT_PUBLIC_CIRCLE_CLIENT_KEYPasskey login on /spawn (Circle console → Modular Wallets). Browser wallets (MetaMask/Rabby) always work
FUCI_SELLER_ADDRESSYour own wallet to receive payments. Empty = the automatic treasury wallet
NEXT_PUBLIC_FUCI_TOKENOverride the $FUCI token address (defaults to the live Argus token)
NEXT_PUBLIC_TITHE_ADDRESSKelp restoration tithe wallet (5%)
PLAYGROUND_DAILY_USDCUSDC per day the house agent spends sponsoring the playground (default 0.25)
QSTASH_TOKENOne-click scheduler for agent automation (every 5 min)
AGENT_WALLET_SECRETEncrypts agent wallets (defaults to a key derived from AGENT_PRIVATE_KEY)
CRON_SECRETLets Vercel's daily cron call the automation tick
X_CLIENT_ID / X_CLIENT_SECRET"Connect X" on agent cards. Create an app at developer.x.com: OAuth 2.0, type "Web App" (confidential), callback https://www.fuci.family/api/x/callback, scopes users.read tweet.read
ANTHROPIC_API_KEYOptional. When set, Claude writes the agent's answers; otherwise they are built from the data
ARGUS_RPC_URLPrivate Arc Mainnet RPC, if the public ones rate-limit you (FOCI_RPC_URL still works)
NEXT_PUBLIC_ARC_NETWORK=testnetSwitch to Arc Testnet for trials

Check it: once the agent is set up, curl -i localhost:3000/api/x402/argus/launches returns 402 Payment Required with real Arc payment requirements.

Automation: agents that run and pay by themselves

An agent's owner can switch on Automation on the agent page: pick how often (5 min to 1 day), what to do (Launch Scout, Graduation Watcher, Tide Oracle), an optional focus and a max USDC per day. Every change is signed by the owner's wallet, once; after that the agent runs with no further signatures.

  • Its own wallet. Switching automation on creates a wallet for that agent. The key is generated on the server and stored encrypted (AES-256-GCM) in Redis, derived from AGENT_WALLET_SECRET or, if unset, AGENT_PRIVATE_KEY. Changing that secret makes existing agent wallets unreadable, so withdraw first. This is custodial: meant for small balances.
  • Funding. The owner clicks Fund (USDC on Arc from their wallet to the agent's). Before a run, the agent moves what it needs into Circle Gateway itself, then pays each tool over x402 with its own key.
  • Limits. Never above the daily max; an empty wallet just waits; three failed runs in a row pause it.
  • Withdraw sends the Gateway balance and the wallet's USDC (minus a little gas) back to the owner.
  • Results go to the agent's History with tx links.

Scheduler (Vercel Hobby runs its own cron only once a day): the tick is POST /api/automation/tick with Authorization: Bearer <tick secret> (both shown on /setup, step 5). Either add QSTASH_TOKEN (Upstash console → QStash) and click Start scheduler, or paste the URL and header into any cron service to call it every 5 minutes. vercel.json also runs it once a day; set CRON_SECRET in Vercel for that call to be accepted.

Repo map
FolderWhat it holds
app/Next.js pages and API routes: x402 tools, MCP, risk, market, setup, agents
components/React UI
lib/Arc, Argus, x402, ERC-8004, risk engine, wallets, trading, storage
contracts/FuciAgentFactory.sol (npm run contracts:build)
mcp/MCP client that pays from your own wallet (npm run mcp:pack)
defillama/DefiLlama fees adapter
video/Remotion launch videos (see video/README.md)
listings/MCP Registry and directory metadata
public/Brand assets

Notes

  • Everything is real: Argus launches are read from Arc Mainnet, payments are real USDC, and stats only count settled payments. There is no sample data.
  • Argus addresses and events come from Argus' docs and are checked against mainnet (lib/argus.ts).
  • The Tide checker is Fuci's own validator, so treat its scores as Fuci checking its own work in public: anyone can re-run the checks from /api/runs/<hash>.
  • Agent outputs and risk grades describe measurable signals. They are not financial advice.

Contributing and security

Issues and pull requests are welcome: see CONTRIBUTING.md. Found a vulnerability? Please follow SECURITY.md instead of opening a public issue. Never commit .env files or keys.


Fuci logo
MIT © 2026 Fuci · built on Arc with Circle Gateway · fuci.family

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.