Price Per TokenPrice Per Token
dflow-mcp

dflow-mcp

by opensvm

GitHub 4 476 uses Remote
0

About

DFlow is a comprehensive MCP server for accessing Kalshi prediction market data—the first CFTC-regulated exchange for trading on real-world events. It enables retrieval of real-time and historical market information through 23 specialized tools covering market analytics, trade history, and sentiment tracking. Key features of DFlow: - Event and market data retrieval with advanced search and filtering by tickers, mints, categories, and sports - OHLC candlestick time series and trade history for technical analysis and price action tracking - Forecast percentile history and analytics for monitoring market sentiment and predictions - Batch market queries and real-time data feeds supporting up to 100 simultaneous lookups - Access to market metadata, series information, and trade milestone data

README

DFlow MCP Server

[](https://smithery.ai/server/@openSVM/dflow-mcp)

Access Kalshi prediction market data - the first CFTC-regulated exchange for trading on real-world events. Built by OpenSVM. 23 tools for events, markets, trades, forecasts, candlesticks and live data.

Demo: https://dflow.opensvm.com

Features

This MCP server provides access to the complete Prediction Market Metadata API including:

  • Event Management: Get events, search events, retrieve event metadata
  • Market Data: Market information, batch queries, market lookups by mint
  • Trading Data: Trade history, trades by market, pagination support
  • Forecast Analytics: Forecast percentile history, time series data
  • Candlestick Data: OHLC data for events and markets
  • Live Data: Real-time data feeds, milestone information
  • Series Information: Series templates, categories, and metadata
  • Utility Functions: Outcome mint queries, filtering, and search capability
  • Installation

    Method 1: Install via Smithery (Recommended)

    The easiest way to install this MCP server is through Smithery:

    npx @smithery/cli install dflow-mcp-server --client claude
    

    This will automatically configure the server for use with Claude Desktop.

    Method 2: Manual Installation

    #### Prerequisites

  • Bun (recommended) or Node.js 18+
  • #### Install Dependencies

    bun install
    

    Usage

    Starting the Server

    # Development mode (with hot reload)
    bun run dev

    Production mode

    bun start

    Or directly with Bun

    bun run src/index.ts

    The server uses stdio transport for MCP communication, which is the standard for MCP clients.

    Integration with MCP Clients

    #### Claude Desktop

    If you installed via Smithery, the configuration is automatic. For manual setup, add this to your Claude Desktop config:

    {
      "mcpServers": {
        "dflow-mcp": {
          "command": "bun",
          "args": ["run", "/path/to/dflow-mcp/src/index.ts"]
        }
      }
    }
    

    #### Other MCP Clients

    This server is compatible with any MCP client (Cursor, Continue, etc.). Use the same configuration format as above.

    Available Tools

    Event Tools

  • get_event - Get a single event by ticker
  • get_events - Get paginated list of all events
  • Market Tools

  • get_market - Get market details by ticker
  • get_market_by_mint - Get market by mint address
  • get_markets - Get paginated list of markets
  • get_markets_batch - Get multiple markets (up to 100)
  • Trade Tools

  • get_trades - Get trades across markets
  • get_trades_by_mint - Get trades for specific market
  • Analytics Tools

  • get_forecast_percentile_history - Get forecast history
  • get_forecast_percentile_history_by_mint - Forecast history by mint
  • get_event_candlesticks - Event candlestick data
  • get_market_candlesticks - Market candlestick data
  • get_market_candlesticks_by_mint - Candlesticks by mint
  • Live Data Tools

  • get_live_data - Get live data for milestones
  • get_live_data_by_event - Live data for event
  • get_live_data_by_mint - Live data by mint
  • Series Tools

  • get_series - Get all series templates
  • get_series_by_ticker - Get specific series
  • Utility Tools

  • get_outcome_mints - Get outcome mint addresses
  • filter_outcome_mints - Filter addresses to outcome mints
  • get_tags_by_categories - Get category-tag mapping
  • get_filters_by_sports - Get sports filtering options
  • search_events - Search events by title/ticker
  • Example Tool Calls

    Get a specific event

    {
      "tool": "get_event",
      "arguments": {
        "event_id": "US-PRESIDENT-2024",
        "withNestedMarkets": true
      }
    }
    

    Get market by mint address

    {
      "tool": "get_market_by_mint",
      "arguments": {
        "mint_address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
      }
    }
    

    Get forecast history

    {
      "tool": "get_forecast_percentile_history",
      "arguments": {
        "series_ticker": "US-PRESIDENT",
        "event_id": "US-PRESIDENT-2024",
        "percentiles": "25,50,75",
        "startTs": 1704067200,
        "endTs": 1706745600,
        "periodInterval": 3600
      }
    }
    

    Search events

    {
      "tool": "search_events",
      "arguments": {
        "q": "election",
        "limit": 10,
        "sort": "volume",
        "order": "desc"
      }
    }
    

    Development

    Project Structure

    dflow-mcp/
    ├── src/
    │   └── index.ts          # Main server implementation
    ├── package.json          # Dependencies and scripts
    ├── tsconfig.json         # TypeScript configuration
    ├── llms_dflow.json       # API specification
    └── README.md             # This file
    

    Building

    bun run build
    

    Testing

    bun run test
    

    API Details

    The server implements the complete REST API defined in llms_dflow.json with the following base URL:

    ``` https://prediction-markets-api.dflow

    Related MCP Servers

    AI Research Assistant

    AI Research Assistant

    hamid-vakilzadeh

    AI Research Assistant provides comprehensive access to millions of academic papers through the Semantic Scholar and arXiv databases. This MCP server enables AI coding assistants to perform intelligent literature searches, citation network analysis, and paper content extraction without requiring an API key. Key features include: - Advanced paper search with multi-filter support by year ranges, citation thresholds, field of study, and publication type - Title matching with confidence scoring for finding specific papers - Batch operations supporting up to 500 papers per request - Citation analysis and network exploration for understanding research relationships - Full-text PDF extraction from arXiv and Wiley open-access content (Wiley TDM token required for institutional access) - Rate limits of 100 requests per 5 minutes with options to request higher limits through Semantic Scholar

    Web & Search
    12 8
    Linkup

    Linkup

    LinkupPlatform

    Linkup is a real-time web search and content extraction service that enables AI assistants to search the web and retrieve information from trusted sources. It provides source-backed answers with citations, making it ideal for fact-checking, news gathering, and research tasks. Key features of Linkup: - Real-time web search using natural language queries to find current information, news, and data - Page fetching to extract and read content from any webpage URL - Search depth modes: Standard for direct-answer queries and Deep for complex research across multiple sources - Source-backed results with citations and context from relevant, trustworthy websites - JavaScript rendering support for accessing dynamic content on JavaScript-heavy pages

    Web & Search
    2 24
    Math-MCP

    Math-MCP

    EthanHenrickson

    Math-MCP is a computation server that enables Large Language Models (LLMs) to perform accurate numerical calculations through the Model Context Protocol. It provides precise mathematical operations via a simple API to overcome LLM limitations in arithmetic and statistical reasoning. Key features of Math-MCP: - Basic arithmetic operations: addition, subtraction, multiplication, division, modulo, and bulk summation - Statistical analysis functions: mean, median, mode, minimum, and maximum calculations - Rounding utilities: floor, ceiling, and nearest integer rounding - Trigonometric functions: sine, cosine, tangent, and their inverses with degrees and radians conversion support

    Developer Tools
    22 81