# Codex MCP Integration

> Real-time, enriched blockchain data for 70 million+ tokens on 80+ networks

## Overview

| Property | Value |
|----------|-------|
| Category | PIPEDREAM |
| Type | PIPEDREAM |
| Tools | 10 |
| URL | https://jelou.ai/es/marketplace/codex |

## Available Tools (10)

### Filter Tokens

Discovers and ranks tokens by on-chain signals such as volume, trending score, liquidity, or market cap. Use this to find trending tokens, top movers, or tokens matching a search phrase. To look up a specific token by its known contract address, use **Get Token Details** instead. Filter to a specific network by passing a numeric `networkId` (e.g., `1` for Ethereum, `137` for Polygon). Use **Get Networks** to find numeric network IDs. [See the documentation](https://docs.codex.io/api-reference/queries/filtertokens)

### Get Networks

Returns all 80+ blockchain networks supported by Codex with their numeric IDs and names. Call this first to resolve `networkId` values required by every other Codex tool. Example: Ethereum = 1, Polygon = 137, BNB Chain = 56, Arbitrum = 42161. [See the documentation](https://docs.codex.io/api-reference/queries/getnetworks)

### Get Pair Stats

Returns metadata and trading statistics for a token pair: price, volume, liquidity, and price changes across multiple timeframes. Use this to analyze DEX pair activity (e.g., Uniswap V2/V3 pools). `statsType` `FILTERED` removes wash trades for cleaner signal; `UNFILTERED` includes all activity. Use **Get Networks** to resolve the numeric `networkId` if needed. [See the documentation](https://docs.codex.io/api-reference/queries/getdetailedpairstats)

### Get Prediction Market Data

Returns prediction market outcomes (Polymarket, Kalshi) with current prices and implied probabilities. Filter by keyword phrase, market IDs, event IDs, protocol, status, liquidity, volume, and more. **Requires a Codex Growth or Enterprise plan** — returns an error on free/Starter plans. Supports offset-based pagination — pass `offset` (and optional `limit`) to fetch subsequent pages (e.g., `offset: 20` with `limit: 20` fetches the second page). [See the documentation](https://docs.codex.io/api-reference/queries/filterpredictionmarkets)

### Get Token Chart

Returns OHLCV (open, high, low, close, volume) candlestick bars for a token over a time range. Use this for price charts, trend analysis, or historical data. Use **Get Networks** to resolve `networkId` if needed. `from` and `to` are Unix timestamps in seconds (e.g., current time = `Math.floor(Date.now() / 1000)`). Valid resolutions: `1` (1 min), `5`, `15`, `30`, `60` (1 hr), `240` (4 hr), `720` (12 hr), `1D`, `7D`. [See the documentation](https://docs.codex.io/api-reference/queries/gettokenbars)

### Get Token Details

Fetches current price, market cap, volume, liquidity, and metadata for one or more specific tokens by contract address. Use this when you already know the token address(es) and want to look up their current data. To discover tokens by name or ranking instead, use **Filter Tokens**. Use **Get Networks** first to resolve the numeric `networkId` if needed. Accepts a JSON array of `{address, networkId}` objects — example: `[{"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "networkId": 1}]`. [See the documentation](https://docs.codex.io/api-reference/queries/tokens)

### Get Token Events

Returns on-chain trading events (swaps, mints, burns) for a token or pair address. Each event includes event type, USD price, timestamp, transaction hash, and maker address. Filter by event type, wallet address, price range, timestamp window, and more. Use **Get Networks** to resolve the numeric `networkId` if needed. Supports cursor-based pagination — pass the `cursor` from the previous response to fetch the next page. [See the documentation](https://docs.codex.io/api-reference/queries/gettokenevents)

### Get Token Holders

Returns the list of token holders with their balances and the top-10 holder concentration percentage. Use this to analyze token distribution and whale concentration. Use **Get Networks** to resolve the numeric `networkId` if needed. Supports cursor-based pagination — pass `cursor` from the previous response to fetch the next page. [See the documentation](https://docs.codex.io/reference/holders)

### Get Wallet Balances

Returns all token holdings and USD values for a wallet address on a specific blockchain network. Use this to inspect what tokens a wallet holds. Use **Get Networks** to resolve the numeric `networkId` if needed (e.g., 1 = Ethereum, 137 = Polygon). [See the documentation](https://docs.codex.io/reference/balances)

### Get Wallet Transactions

Returns token holdings and aggregated trading stats for one or more wallet addresses. Each result includes token balance, realized P&L, buy/sell counts, and average hold period across 1d, 1w, 30d, and 1y windows. Filter by wallet address, token, network, labels, or numeric range filters. Use **Get Networks** to resolve the numeric `networkId` if needed. Supports offset-based pagination — pass `offset` (and optional `limit`) to fetch subsequent pages. [See the documentation](https://docs.codex.io/api-reference/queries/filtertokenwallets)

## Supported Channels

This integration works with:
- WhatsApp Business API
- Facebook Messenger
- Instagram Direct Messages
- Web Chat Widget

## AI Assistants Compatible

- ChatGPT (via MCP)
- Claude (via MCP)
- Gemini (via MCP)
- Custom AI Agents

## Quick Start

1. Sign up at https://apps.jelou.ai/signup
2. Navigate to Marketplace and add Codex
3. Authenticate your Codex account
4. Configure your messaging channels (WhatsApp, Facebook, etc.)
5. Copy the MCP server URL to your AI assistant

## Example Use Cases

- Automate customer inquiries using Codex data
- Send notifications via WhatsApp when Codex events occur
- Query Codex data directly from ChatGPT or Claude
- Build AI agents that interact with Codex

## Resources

- [All Integrations](https://jelou.ai/es/marketplace)
- [Full Documentation](https://jelou.ai/llms-full.txt)
- [API Docs](https://docs.jelou.ai)
- [Help Center](https://help.jelou.ai)
