MCP-IQWiki
A Model Context Protocol server that allows AI assistants and applications to access IQ.wiki data, enabling retrieval of specific wikis, user-created wikis, user-edited wikis, and detailed wiki activities.
README Documentation
📚 IQ Wiki MCP Server
📖 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
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 |
👨💻 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 definitionssrc/services/: API client and business logicsrc/lib/: Shared utilitiessrc/index.ts: Server entry point
📚 Resources
⚠️ 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.