MCP-IQWiki: Model Context Protocol Server for IQ.wiki

by IQAIcom

1 stars
209 downloads
Not rated
GitHub Website

About

Access data and information from IQ.wiki, the world's largest crypto and blockchain encyclopedia.

Details

Author
IQAIcom
GitHub stars
1
Downloads
209
Categories
Database, Finance, Other, Knowledge Base

- Retrieve detailed wiki articles by ID.
- Track wikis created by a specific Ethereum address.
- Track wikis edited by a specific Ethereum address.
- Monitor wiki activities with optional time filtering.
- Search for wiki articles using natural language queries.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP-IQWiki: Model Context Protocol Server for IQ.wiki
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Run the server via npx @iqai/mcp-iqwiki or pnpm dlx @iqai/mcp-iqwiki, or build from source. Configure it in an MCP client (e.g., Claude Desktop) by adding a JSON entry to your MCP settings. Use the provided MCP tools to retrieve, search, and track wiki content.

GET_WIKI

Get details about a specific wiki from IQ.wiki by ID

GET_USER_CREATED_WIKIS

Get wikis created by a specific user on IQ.wiki

GET_USER_EDITED_WIKIS

Get wikis edited by a specific user on IQ.wiki

GET_USER_WIKI_ACTIVITIES

Get wiki activities (creations or edits) for a specific user on IQ.wiki

SEARCH_WIKI

Search for a wiki from IQ.wiki by query

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp-iqwiki: model context protocol server for iq.wiki": {
            "mcp-iqwiki": {
                "command": "npx",
                "args": [
                    "@iqai/mcp-iqwiki"
                ]
            }
        }
    }
}

McpServers

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

πŸ“š IQ Wiki MCP Server

npm version
License: MIT

πŸ“– Overview

The IQ Wiki MCP Server enables AI agents to interact with IQ.wiki, a blockchain-powered encyclopedia for crypto and DeFi knowledge. This server provides comprehensive access to wiki data, user contributions, and activity tracking.

By implementing the Model Context Protocol (MCP), this server allows Large Language Models (LLMs) to discover wiki articles, search for knowledge, and track user wiki activities directly through their context window, bridging the gap between AI and decentralized knowledge.

✨ Features

Wiki Access: Retrieve detailed information about any wiki article on IQ.wiki by ID.
User Contributions: Track wikis created or edited by specific users based on their Ethereum address.
Activity Tracking: Monitor detailed wiki activities (creations and edits) with optional time filtering.
Search: Search for wiki articles using natural language queries.

πŸ“¦ Installation

πŸš€ Using npx (Recommended)

To use this server without installing it globally:

npx @iqai/mcp-iqwiki

πŸ“¦ Using pnpm dlx

pnpm dlx @iqai/mcp-iqwiki

πŸ”§ Build from Source

git clone https://github.com/IQAIcom/mcp-iqwiki.git
cd mcp-iqwiki
pnpm install
pnpm run build

⚑ Running with an MCP Client

Add the following configuration to your MCP client settings (e.g., claude_desktop_config.json).

πŸ“‹ Minimal Configuration

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

βš™οΈ Advanced Configuration (Local Build)

{
  "mcpServers": {
    "iq-wiki": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-iqwiki/dist/index.js"]
    }
  }
}

πŸ’‘ Usage Examples

πŸ” Wiki Discovery

"Get the wiki article for Bitcoin" "Search for wikis about DeFi protocols" "Find information about Ethereum"

πŸ‘€ User Contributions

"What wikis has 0x8AF7a19a26d8FBC48dEfB35AEfb15Ec8c407f889 created?" "Show wikis edited by this user in the last 24 hours" "Get all wiki activities for this Ethereum address"

πŸ“Š Activity Tracking

"List recent wiki creations by user 0x..." "Show wiki edits in the last hour" "Track user wiki contributions over time"

πŸ› οΈ MCP Tools

<!-- AUTO-GENERATED TOOLS START -->

GET_USER_CREATED_WIKIS

Get wikis created by a specific user on IQ.wiki

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| id | string | βœ… | The Ethereum address of the user |
| timeFrameSeconds | number | | Optional time frame in seconds to filter results |

GET_USER_EDITED_WIKIS

Get wikis edited by a specific user on IQ.wiki

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| id | string | βœ… | The Ethereum address of the user |
| timeFrameSeconds | number | | Optional time frame in seconds to filter results |

GET_USER_WIKI_ACTIVITIES

Get wiki activities (creations or edits) for a specific user on IQ.wiki

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| id | string | βœ… | The Ethereum address of the user |
| activityType | string | | Type of activity: CREATED or UPDATED |
| timeFrameSeconds | number | | Optional time frame in seconds to filter results |

GET_WIKI

Get details about a specific wiki from IQ.wiki by ID

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| id | string | βœ… | The ID of the wiki to retrieve |

SEARCH_WIKI

Search for a wiki from IQ.wiki by query

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| query | string | βœ… | The query to search for |

<!-- AUTO-GENERATED TOOLS END -->

πŸ‘¨β€πŸ’» Development

πŸ—οΈ Build Project

pnpm run build

πŸ‘οΈ Development Mode (Watch)

pnpm run watch

βœ… Linting & Formatting

pnpm run lint
pnpm run format

πŸ§ͺ Testing

pnpm test

πŸ“ Project Structure

src/tools/: Individual tool definitions src/services/: API client and business logic src/lib/: Shared utilities src/index.ts: Server entry point

πŸ“š Resources

IQ.wiki Platform
Model Context Protocol (MCP)
IQ.wiki Documentation

⚠️ Disclaimer

This tool interacts with IQ.wiki blockchain data. Users should verify all information independently. Wiki content is community-contributed and may change over time.

πŸ“„ License

MIT

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.