# @omni-fun/mcp-server

MCP server for [omni.fun](https://omni.fun) — the multichain memecoin launchpad. Exposes token data, trading info, and bonding curve queries to AI agents across 8 chains.

## Tools

| Tool | Description |
|------|-------------|
| `get_trending_tokens` | Get trending tokens sorted by volume, market cap, or recent activity |
| `search_tokens` | Search tokens by name, symbol, or address |
| `get_token_details` | Get detailed token info including bonding curve state, price, market cap |
| `get_price_quote` | Get a price quote for buying or selling a token on any supported chain |
| `get_bonding_curve` | Get bonding curve parameters and graduation progress |
| `simulate_trade` | Simulate a buy or sell trade with fee breakdown |
| `get_chain_info` | Get supported chain details including bridge paths and settlement times |
| `get_graduating_tokens` | Get tokens approaching the $69K graduation threshold |

## Installation

```bash
npm install @omni-fun/mcp-server
```

## Usage

### As an MCP server

```json
{
  "mcpServers": {
    "omni-fun": {
      "command": "npx",
      "args": ["@omni-fun/mcp-server"]
    }
  }
}
```

### Claude Desktop

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "omni-fun": {
      "command": "npx",
      "args": ["@omni-fun/mcp-server"]
    }
  }
}
```

## Supported Chains

Base, Arbitrum, Optimism, Polygon, BSC, Ethereum, Avalanche, Solana

## Key Concepts

- **Bonding Curve**: Linear price curve. Tokens start at floor price, graduate at $69K market cap
- **Graduation**: Auto-migrates to Uniswap V3 with locked liquidity
- **Creator Fee**: 0.5% of every trade goes to the token creator forever
- **Cross-Chain**: Tokens deploy as OFTs on 8 chains via LayerZero V2
- **oScore**: 7-factor trust rating (0-100) on every token

## API

Public endpoints require no authentication. The MCP server uses `https://api.omni.fun` as the backend.

## Links

- [omni.fun](https://omni.fun)
- [API Docs](https://app.omni.fun/.well-known/openapi.json)
- [npm](https://www.npmjs.com/package/@omni-fun/mcp-server)

## License

MIT