Using the MCP API

ToekomstTech exposes a Model Context Protocol (MCP) server that lets you connect AI assistants — Claude, ChatGPT, or any MCP-compatible client — directly to the space's data and tools.

What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI assistants to access external data sources and tools in a structured way. By connecting your AI assistant to ToekomstTech's MCP server, it gains access to:

• Wiki pages — the AI can read and cite wiki content
• Members directory — who's in the space right now, member profiles (respecting privacy settings)
• Projects — current active projects, skills wanted, project updates
• Events — upcoming events, event details
• Inventory — tool availability and status
• Presence — who's checked in to the space right now

This means you can ask your AI assistant things like: "Who in the space knows RF electronics?" or "Is the oscilloscope available?" or "Summarise the active projects that need help."

Generating your API key

1. Go to your profile page and click API Keys.
2. Click Generate MCP Key.
3. Copy the key — it won't be shown again. Store it in your password manager.

Your API key is tied to your membership role. The AI will only be able to access data that your role can access.

Connecting Claude Desktop

Add this to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "toekomsttech": {
      "command": "npx",
      "args": ["-y", "@toekomsttech/mcp-server"],
      "env": {
        "TOEKOMSTTECH_API_KEY": "your-api-key-here",
        "TOEKOMSTTECH_BASE_URL": "https://base.toekomst.org"
      }
    }
  }
}

Restart Claude Desktop. You should see "toekomsttech" appear as a connected tool.

Connecting via HTTP (for custom integrations)

The MCP server is also accessible as a standard HTTP API:

Base URL: https://base.toekomst.org/mcp/v1
Auth: Bearer <your-api-key>

Available endpoints:

GET /wiki              — list all accessible wiki pages
GET /wiki/:slug        — get a specific wiki page
GET /members           — list members (respects privacy settings)
GET /presence          — get current check-in status
GET /projects          — list projects
GET /events            — list upcoming events
GET /inventory         — list tools and their status

Example: querying the API with curl

curl https://base.toekomst.org/mcp/v1/presence \
  -H "Authorization: Bearer your-api-key-here"

Response:

{
  "present": [
    { "displayName": "Alice", "since": "2025-03-15T14:23:00Z" },
    { "displayName": "Bob", "since": "2025-03-15T09:00:00Z" }
  ],
  "count": 2
}

Privacy and rate limits

• The API respects member privacy settings. Members who opt out of presence tracking won't appear in presence results.
• Rate limit: 60 requests per minute per API key.
• Bulk export is not permitted. The API is for interactive use, not data scraping.

If you build something useful with the API, share it in #tech on Slack and consider contributing it to the platform. See Platform Development Guide for how to contribute.