Intuition MCP Server

The Intuition MCP Server is an HTTP stream server designed to interact with the Intuition knowledge graph, enabling users to query and manage data through a set of powerful tools. It provides a robust API for extracting triples, searching for entities (atoms), retrieving account information, and exploring relationships such as followers and following. This README outlines the steps to get started, the available tools, their functionalities, and instructions for running a client using the Model Context Protocol (MCP) SDK.

This repository represents the evolution of our Intuition MCP Server, which we are pleased to be open sourcing for our ecosystem. This is built upon the foundation and testing we’ve done. There are several contributors who helped get to this point, including francoispqt, jonathanprozzi, and simonas-notcat.

Table of Contents

• Intuition MCP Server
  • Table of Contents
  • Get Started
  • Overview
  • Tools
    • extract_triples
    • search_atoms
    • get_account_info
    • search_lists
    • get_following
    • get_followers
    • search_account_ids
  • Running a Client
    • Prerequisites
  • Installation
    • Example Client Setup
  • Making API Requests
    • Notes
  • Deployment
  • Contributing
  • License

Get Started

To run the Intuition MCP Server locally, follow these steps:

Clone the Repository: Clone the project repository to your local machine:

git clone 
cd intuition-mcp-server

Install Dependencies: Install the required dependencies using pnpm:

pnpm install

Start the Server: Launch the server using the HTTP transport (recommended):

pnpm run start:http

This will start the Intuition MCP Server, making it available at the configured host and port (e.g., http://localhost:3001). Check the server configuration for the exact URL.

Verify the Server: Once the server is running, you can test it by sending a request to the /mcp endpoint (for Streamable HTTP clients) or /sse endpoint (for legacy SSE clients). See the Running a Client (#running-a-client) section for details on connecting a client. We follow the most recent recommendations from the MCP SDK and recommend using the Streamable HTTP endpoint (/mcp) over SSE as it is in the process of being deprecated.