IQ Wiki

Model Context Protocol Server for interacting with IQ.wiki content

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "iqaicom-mcp-iqwiki": {
      "command": "npx",
      "args": [
        "-y",
        "@iqai/mcp-iqwiki"
      ]
    }
  }
}

You can run IQ Wiki MCP Server to let AI agents access IQ.wiki data, search articles, and track user contributions and activities through the Model Context Protocol. This server exposes wiki details, user-created and edited content by Ethereum addresses, and activity timelines in a way that LLMs can query and incorporate into their reasoning and responses.

How to use

You run the server locally or host it and connect it to your MCP client. The server provides tools to discover IQ.wiki articles by ID, search for articles using natural language, and retrieve user contributions and activities tied to Ethereum addresses. Use the client’s MCP configuration to register the server and then issue queries like discovering a wiki article, searching for topics, or listing a user’s wiki activities.

How to install

Prerequisites: Node.js and a modern package manager installed on your system. You should have either Node.js available to run JavaScript files directly or access to a package runner that can execute MCP server bundles.

Additional configuration and notes

There are two supported ways to run IQ Wiki MCP Server through an MCP client: a quick start using npx for a temporary run, and a local build for a persistent, offline-ready setup.

Minimal configuration focuses on a lightweight runtime that’s easy to try. Advanced configuration covers running from a built local distribution for more control in production environments.

Examples and usage patterns

Here are typical usage scenarios you can perform with the server included in your MCP client configuration. You can discover a wiki article by its title or ID, search for articles related to DeFi topics, or obtain a history of wikis created or edited by a given Ethereum address.

Development and project structure

The project is organized with source code for individual MCP tools, API clients, shared utilities, and the server entry point. Build and development commands are provided to compile and run the server locally, and tests ensure expected behavior.

Security and reliability

Interacting with IQ.wiki blockchain data requires careful verification of results. Wiki content is community-contributed and may change over time. Validate outputs in critical scenarios and treat the data as informational rather than authoritative without independent checks.

Tools and endpoints

The server exposes a set of end-user tools to query IQ.wiki data. Use these tools through your MCP client to retrieve specific wiki details, perform searches, and fetch user activity data.

Available tools

GET_USER_CREATED_WIKIS

Fetch wikis created by a specific user using their Ethereum address. Optional timeFrameSeconds filters results to a recent window.

GET_USER_EDITED_WIKIS

Fetch wikis edited by a specific user using their Ethereum address. Optional timeFrameSeconds filters results to a recent window.

GET_USER_WIKI_ACTIVITIES

Retrieve wiki activities (creations or updates) for a specific user. You can filter by a time frame and specify the activity type (CREATED or UPDATED).

GET_WIKI

Get details about a single wiki article from IQ.wiki by its ID.

SEARCH_WIKI

Search for wiki articles on IQ.wiki using a natural language query.