# CoinFactory — Agent Skill

CoinFactory is a read-only crypto discovery and intelligence service built for
AI agents. It answers: what is this token, what is it worth, what is trending,
what just launched, and how risky is it. It does not trade, custody, or deploy
anything.

## Connect

### MCP (Claude Desktop, Claude Code, Cursor, OpenClaw, any MCP client)

Remote server URL (Streamable HTTP, no auth required):

    https://coinfactory.ai/mcp

Claude Code:

    claude mcp add --transport http coinfactory https://coinfactory.ai/mcp

Cursor / Claude Desktop / generic (mcp.json / claude_desktop_config.json):

    { "mcpServers": { "coinfactory": { "url": "https://coinfactory.ai/mcp" } } }

OpenClaw (or any agent that can read a URL): read this file, then call the
tools below over MCP, or use the REST equivalents.

### REST

Every tool has a GET endpoint. All responses are JSON with CORS enabled.

    GET https://coinfactory.ai/api/v1/search?q=pepe
    GET https://coinfactory.ai/api/v1/tokens/{id|symbol|address}
    GET https://coinfactory.ai/api/v1/tokens/{id|symbol|address}/risk
    GET https://coinfactory.ai/api/v1/market?ids=bitcoin,ethereum
    GET https://coinfactory.ai/api/v1/market?limit=100            (top by market cap)
    GET https://coinfactory.ai/api/v1/trending?source=coingecko|dex&chain=base
    GET https://coinfactory.ai/api/v1/new?chain=solana&minLiquidityUsd=10000
    GET https://coinfactory.ai/api/v1/global

## Tools

- search_tokens({ query, limit? })            — resolve name / symbol / address → tokens (readOnly)
- get_token({ token, chain? })                — full profile: price, caps, supply, links, pools (readOnly)
- get_market_data({ ids?, limit? })           — prices for up to 50 ids, or top N by market cap (readOnly)
- get_trending({ source?, chain?, limit? })   — most-searched coins, or hottest DEX pools (readOnly)
- get_new_tokens({ chain?, limit?, minLiquidityUsd? }) — pools created in the last ~hour (readOnly)
- get_risk_signals({ token, chain? })         — 0–100 risk score + explained signals (readOnly)
- get_global_stats({})                        — total market cap, volume, BTC dominance (readOnly)

Chains: ethereum, base, solana, bsc, arbitrum, optimism, polygon, avalanche.

## Recommended workflow

1. search_tokens to resolve what the user means ("pepe" → id "pepe").
2. get_token for the numbers; get_risk_signals before forming any opinion.
3. Quote the risk level and the top signals verbatim — they are explanations,
   not just flags. Never describe a token as "safe"; the best outcome is
   "no major red flags found".
4. For get_new_tokens results, assume scam until risk signals say otherwise.

## Rules & limits

- Anonymous use: 60 requests per minute per IP. Responses are cached 1–5 min.
- Data comes from CoinGecko, GeckoTerminal and GoPlus. It can be delayed,
  incomplete or wrong. Always say so when relaying it.
- Nothing from this service is financial advice. Do not present it as such.
- The risk score is a heuristic: higher = more observed risk. A low score is
  not an endorsement. Coverage fields tell you which checks actually ran.

Docs: https://coinfactory.ai/docs · Risk model: https://coinfactory.ai/safety

## Trading tools (Base, beta) — non-custodial

- get_swap_quote({ sellToken, buyToken, sellAmount, slippageBps? })      — price incl. fees + buy-token risk (readOnly)
- build_swap_transaction({ ...same, taker, acknowledgeRisk? })          — UNSIGNED tx (+ approval tx) for the taker to sign
- get_swap_status({ txHash })                                            — pending / success / reverted (readOnly)

    REST: GET  https://coinfactory.ai/api/v1/swap/quote?sellToken=ETH&buyToken=<addr>&sellAmount=0.1
          POST https://coinfactory.ai/api/v1/swap/build   { sellToken, buyToken, sellAmount, taker, slippageBps?, acknowledgeRisk? }
          GET  https://coinfactory.ai/api/v1/swap/status/{txHash}

How it works: CoinFactory asks a DEX aggregator (0x) for a route with a
1% CoinFactory fee embedded; the fee is split on-chain in the same
transaction and sent to 0x08063Cc8BFbE828Eca15A90572C8a8be3290590B. The agent's own wallet signs and
broadcasts. CoinFactory never holds funds or keys, never submits transactions,
and cannot reverse anything. Never send private keys or seed phrases to any tool.

Rules: Base only · min $1 · beta cap $1000 per trade · max slippage
500 bps · swaps INTO critical-risk / honeypot tokens are refused · high-risk
tokens require acknowledgeRisk: true AFTER you have shown the risk signals to the
user. Always show the user the full quote (amounts, fee, aggregator fee, gas) before
building, and the tx hash after.