Otherside docs and live NFT markets, inside your AI assistant

OSWiki MCP gives Claude, Cursor and VS Code 11 tools over the same data as oswiki.xyz: floors, traits, listings and wallets on Ethereum and ApeChain, plus the MML, Otherside and ODK docs. No API key.

claude mcp add --transport http --scope user oswiki

--scope user adds it for all projects (the default local scope only covers the current folder). /mcp inside Claude Code then shows oswiki as connected.

{
  "mcpServers": {
    "oswiki": {
      "url": ""
    }
  }
}

Add to ~/.cursor/mcp.json and restart Cursor.

Settings → Connectors → Add custom connector, paste the URL and restart Claude Desktop.

{
  "servers": {
    "oswiki": {
      "type": "http",
      "url": ""
    }
  }
}

Save as .vscode/mcp.json and reload the window.

Server URL

Other clients, the config-file route and the REST API:

Trade from your AI with the local signer oswiki-sign:

Example sessionLive data

You

Top collections by volume today?

oswiki

get_oswiki_collectionsrunning{ chain: "ethereum", sort: "volume", period: "24h", limit: 5 }

get_oswiki_collectionsrunning{ chain: "apechain", sort: "volume", period: "24h", limit: 5 }

Assistant

Collection	Floor	Vol 24h	24h

From api.oswiki.xyz/v1

Try asking

Click a question to copy it. The tool your assistant reaches for is listed under each.

Tools

Market and NFT data

Live from api.oswiki.xyz on Ethereum and ApeChain.

get_oswiki_market: Floors, trait supply, price history, ETH/APE prices
get_oswiki_collections: Rank and discover collections on Ethereum and ApeChain
browse_oswiki: Browse NFTs and listings with trait filters, holders
get_oswiki_asset: One NFT: traits, rarity, owner, listing, history
get_oswiki_activity: Recent sales and new listings
get_oswiki_wallet: Wallet holdings, activity, Otherside XP rank
get_oswiki_experiences: Otherside experiences, developers, avatar collections

Docs

Otherside, MML, ODK and Msquared documentation.

search_docs: Search all Otherside, MML, ODK and Msquared docs
get_mml_docs: MML elements, events and guides
get_otherside_docs: Otherside, ecosystem and Msquared docs, changelog

ODK

The Otherside Development Kit class reference.

get_odk_blueprint: 1,200+ Blueprint classes and 3,000+ functions, structs

Every tool is also callable over plain HTTP: . Trading tools (list, buy, cancel, offers) come from the separate local signer oswiki-sign:

Installation

Every client connects to the same server URL. No API key or account needed.

Server URL

Client

Claude Code

Add the server from the terminal, or share it with a project file.

Add the server

Run once in any terminal:
Terminal
```
claude mcp add --transport http --scope user oswiki 
```
--scope user makes it available in all projects; without it Claude Code uses the local scope, which only covers the current folder.

Or commit a .mcp.json in the project root so everyone on the project gets it:
.mcp.json
```
{
  "mcpServers": {
    "oswiki": {
      "type": "http",
      "url": ""
    }
  }
}
```
Verify it works

Check with /mcp inside Claude Code: oswiki should be connected with 11 tools. Then ask:
Higher rate limits (optional)

Without a key you share the server's limit with everyone else. Create your own key at oswiki.xyz → Account → Developer and send it as a header; your requests then use your own quota:
Terminal
```
claude mcp add --transport http --scope user oswiki  --header "X-API-Key: oswk_your_key"
```
The key is only forwarded to api.oswiki.xyz for your requests; the MCP server never stores or logs it.

No account? Agents can call get_instant_api_key (free key, 60 req/min, 7 days), or run curl -X POST https://api.oswiki.xyz/v1/auth/keys.

Cursor

One entry in Cursor's MCP config, globally or per project.

Add the server

Open Settings → MCP → Add new global MCP server and add:
~/.cursor/mcp.json
```
{
  "mcpServers": {
    "oswiki": {
      "url": ""
    }
  }
}
```
For a single project, put the same file at .cursor/mcp.json in the project root.
Restart Cursor

After the restart, oswiki shows up in the tool list.
Verify it works

Ask in Agent chat:
Higher rate limits (optional)

Add your own OSWiki API key (oswiki.xyz → Account → Developer) as a header so your requests use your own quota instead of the shared one:
~/.cursor/mcp.json
```
{
  "mcpServers": {
    "oswiki": {
      "url": "",
      "headers": { "X-API-Key": "oswk_your_key" }
    }
  }
}
```

Claude Desktop

Add OSWiki as a custom connector, or bridge it through the config file.

Add a custom connector

Go to Settings → Connectors → Add custom connector and paste the URL:

Connector URL

Prefer the config file? It only accepts local (stdio) servers, so bridge it with mcp-remote (needs Node.js):

claude_desktop_config.json

# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "oswiki": {
      "command": "npx",
      "args": ["mcp-remote", ""]
    }
  }
}

Restart Claude Desktop

The OSWiki tools appear in the tools menu.
Verify it works

Start a new chat and ask:
Rate limits

Custom connectors in Claude Desktop cannot send custom headers, so they always use the shared rate limit. For your own quota, use the mcp-remote config above with "--header", "X-API-Key: oswk_your_key" added to args, or use Claude Code, Cursor or VS Code.

VS Code

Uses GitHub Copilot Chat, which ships with VS Code. Make sure it is enabled and you are signed in.

Add the server

Create .vscode/mcp.json in your project:
.vscode/mcp.json
```
{
  "servers": {
    "oswiki": {
      "type": "http",
      "url": ""
    }
  }
}
```
VS Code uses "servers" with "type": "http", not Cursor's "mcpServers". To add it for all projects, run MCP: Add Server from the command palette.
Reload the window

Ctrl+Shift+P → Reload Window.
Verify it works

Open Copilot Chat in Agent mode and ask:

Higher rate limits (optional)

Send your own OSWiki API key (oswiki.xyz → Account → Developer); VS Code prompts for it once and keeps it in its secret storage:

.vscode/mcp.json

{
  "inputs": [
    { "type": "promptString", "id": "oswiki-key", "description": "OSWiki API key", "password": true }
  ],
  "servers": {
    "oswiki": {
      "type": "http",
      "url": "",
      "headers": { "X-API-Key": "${input:oswiki-key}" }
    }
  }
}

REST API

Every tool is also callable over plain HTTP.

HTTP

# Health
GET 

# Tools
GET 

# Call
POST 
{
  "tool": "search_docs",
  "arguments": { "query": "m-cube" }
}

curl

curl -X POST  \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_docs","arguments":{"query":"animation"}}'

Optional: add -H "X-API-Key: oswk_your_key" (or Authorization: Bearer oswk_…) to use your own OSWiki rate limit instead of the shared one.

Trading (oswiki-sign)

oswiki-sign is a local signer that lets your AI list, buy (OSWiki and OpenSea listings), cancel, make and accept offers, and send NFTs or funds. The key stays on your computer; every trade is previewed and, by default, approved by you in its own dialog.

Node.js 20 or newer

Check with node -v. If it is missing, install the LTS from nodejs.org, or run winget install OpenJS.NodeJS.LTS (Windows) or brew install node (macOS).
Run the setup

In any terminal, from any folder:
Terminal
```
npx -y @oswikixyz/sign@0.2.6 setup
```
It creates or imports a trading wallet, asks for your limits and adds oswiki-sign to Claude Code, Cursor or Claude Desktop.
Fund the trading wallet

Send the NFTs you want to trade to the address the setup shows, plus a little ETH (Ethereum) or APE (ApeChain) for gas.
Restart your client and check

Keep the OSWiki MCP installed too: it supplies the data, oswiki-sign does the signing. Then ask:

Safety

Use a separate trading wallet that only holds what you want to trade.
Never paste the key or seed phrase into a chat; the setup reads it locally.
Limits are enforced locally (max per buy, daily caps, floor guard, collection whitelist) and can be changed in chat with your approval.
Every trade is previewed first and, by default, only sent after you approve it in oswiki-sign's own dialog. Sending NFTs or funds always needs your approval.

Source on GitHub, package on npm (published with npm provenance).

Changelog

Changes to the OSWiki MCP server and its tools.

1.1.0-beta

Oct 11, 2026

New tool get_oswiki_offers: best item and collection offers for an NFT with what the seller receives, all offers on a collection, and a wallet's offers, on Ethereum and ApeChain.
New tool get_instant_api_key: a free API key without login (60 requests per minute, 7 days) that the session then uses automatically. Your own key can also be sent as X-API-Key.
Value answers: get_oswiki_asset view value and Otherdeed trait queries show the last sale, dated sales of comparable tokens, floors per tier and, for Otherdeeds, a fair value labelled as a model estimate. Resources are matched with their own tier.
get_oswiki_market: trait_floors for any collection, floor price history for every collection including ApeChain (30 days), and ApeCoin / ETH price history.
Trading through the local signer oswiki-sign: setup guide (get_trading_setup) and an Installation section.
Fixes from an independent test round: activity feeds, wallet views, listings, trait filters by slug, search links, name lookup, number formatting, clearer errors and empty states.

1.0.0-beta

Oct 10, 2026

Removed validate_glb and its bundled avatar toolkit. 11 tools, lighter and faster builds.
Dropped a stale hardcoded collection address list; collections are always resolved live from OSWiki.

1.0.5-alpha

Aug 19, 2026

New tool get_oswiki_collections: discover and rank collections on ApeChain (1000+) and Ethereum by volume, floor, sales or holders, search by name or address, verified-only, or get one collection's full profile (links, verification, royalty, floor, volume and sales across 24h / 7d / 30d / all).
get_oswiki_market (query=collection), get_oswiki_asset and get_oswiki_activity gained a chain parameter and work for any indexed collection (slug or 0x address): token traits, rarity, owner, current listing with buyable askId, last sale, chain-wide sales feed and recently listed OSWiki items.
Live-data tools read the documented api.oswiki.xyz/v1 (collections, tokens, sales, listings) instead of internal routes, with oswiki.xyz links in every payload.
Optional OSWIKI_API_KEY gives the server its own API quota instead of the shared anonymous limit.

1.0.4-alpha

Jun 16, 2026

Docs are ingested as GitBook Markdown via the sitemap index, which recovered the ODK v10 / v9.4 release notes, upgrade guides and platform docs.
Removed empty collections, about 120 lines of dead code and the cheerio dependency.
Blueprint scraping is paused until a v10 source exists; get_odk_blueprint keeps serving the last good data.
The deploy pipeline no longer reports false failures after a successful deploy.

1.0.3-alpha

Mar 6, 2026

15 tools merged into 11: MML docs into get_mml_docs, Otherside docs into get_otherside_docs.
Shared MongoDB connections, tuned cache TTLs, shared response helpers.
Slow-tool and error logging.

1.0.2-alpha

Jan 7, 2026

Parallel searches, API timeouts, deterministic caching.
Retry with backoff, rate limiting, IPFS fallbacks.
Filters for resource and artifact categories, obelisk pieces, rarity rank.
Fixed activity types, price history parameters and the GLB size limit.

1.0.1-alpha

Jan 2026

Otherside rank and progression view for wallets.
VS Code (Copilot) install guide.

1.0.0-alpha

Dec 2025

First release: MML, ODK, market data, wallet and avatar validation tools.

Otherside docs and live NFT markets, inside your AI assistant

Try asking

Tools

Market and NFT data

Docs

ODK

Installation

Claude Code

Add the server

Verify it works

Higher rate limits (optional)

Cursor

Add the server

Restart Cursor

Verify it works

Higher rate limits (optional)

Claude Desktop

Add a custom connector

Restart Claude Desktop

Verify it works

Rate limits

VS Code

Add the server

Reload the window

Verify it works

Higher rate limits (optional)

Unreal Engine

REST API

Trading (oswiki-sign)

Node.js 20 or newer

Run the setup

Fund the trading wallet

Restart your client and check

Safety

Changelog

1.1.0-beta

1.0.0-beta

1.0.5-alpha

1.0.4-alpha

1.0.3-alpha

1.0.2-alpha

1.0.1-alpha

1.0.0-alpha