Meteor Wormhole — Connect Your Meteor Methods to AI Agents (MCP + REST + Swagger)

announce
1

Hey everyone! :wave:

I’ve been working on a package called Meteor Wormhole and I’m excited to share it with the community. In short, it turns your existing Meteor.methods into tools that AI agents can discover and call — no rewriting required.

What Is It?

Meteor Wormhole is a server-only Meteor 3.4+ package that bridges your Meteor methods to the outside world through:

  • MCP (Model Context Protocol) — The open standard for connecting AI assistants to tools and data. Your methods become MCP tools that Claude, GPT, Cursor, VS Code Copilot, and any MCP-compatible client can discover and invoke.
  • REST API — Every exposed method also gets a POST /api/<method> endpoint.
  • OpenAPI 3.1 spec — Auto-generated from your method schemas.
  • Swagger UI — Built-in interactive API docs at /api/docs.

How It Works

Two lines to get started:

import { Wormhole } from 'meteor/wreiske:meteor-wormhole';

Wormhole.init(); // That's it — all your methods are now MCP tools

By default it runs in “all-in” mode, which automatically exposes every Meteor.methods() call (minus DDP internals, private _-prefixed methods, and Accounts methods). You can also run in “opt-in” mode for explicit control:

Wormhole.init({ mode: 'opt-in' });

Wormhole.expose('todos.add', {
  description: 'Add a new todo item',
  inputSchema: {
    type: 'object',
    properties: {
      title: { type: 'string', description: 'The todo title' },
      priority: { type: 'string', enum: ['low', 'medium', 'high'] }
    },
    required: ['title']
  }
});

Add richer schemas and descriptions, and AI agents get better context about what your tools do and how to call them.

Features at a Glance

  • Zero-config MCP server — Streamable HTTP transport at /mcp, session management, JSON-RPC 2.0
  • Optional REST bridge — Enable with rest: { enabled: true } for traditional HTTP clients
  • Auto-generated OpenAPI 3.1 spec with Swagger UI
  • Optional API key auth — Covers both MCP and REST endpoints
  • Smart exclusions — Automatically skips DDP internals, _private methods, and Accounts methods; add your own patterns
  • Input validation — JSON Schema → Zod conversion for parameter validation
  • Error propagation — Meteor.Error details are properly passed through to clients
  • Enrich existing methods — Add descriptions and schemas to auto-registered methods with Wormhole.expose()

Configuration Options

Wormhole.init({
  mode: 'all',             // 'all' or 'opt-in'
  path: '/mcp',            // MCP endpoint path
  name: 'my-app',          // MCP server name
  apiKey: 'secret',        // Optional bearer token auth
  exclude: [/^admin\./],   // Additional exclusion patterns
  rest: {
    enabled: true,         // Enable REST API
    path: '/api',          // REST base path
    docs: true             // Swagger UI at /api/docs
  }
});

Live Demo & Chat App

I’ve deployed a live test app you can poke around with. It includes a dozen example methods (todos, math, string transforms, error handling, etc.) with Swagger UI so you can try the REST API directly in your browser.

Screenshot 2026-03-06 at 10.07.26 PM
Screenshot 2026-03-06 at 10.07.26 PM2312×1696 316 KB

There’s also a chat app included in the repo that demonstrates the other side of the coin — a Meteor app acting as an MCP client, connecting to external MCP servers, discovering their tools, and feeding them into an AI chat loop with multi-provider support (OpenAI, Anthropic, Google Gemini, Groq, Mistral, and more).

Screenshot 2026-03-06 at 10.09.17 PM
Screenshot 2026-03-06 at 10.09.17 PM2392×1674 432 KB

Point Your MCP Client at It

If you use Claude Desktop, Cursor, VS Code Copilot, or any other MCP-compatible client, you can connect to a Wormhole-enabled app and your AI assistant will immediately see all the exposed methods as callable tools. Just point it at your app’s /mcp endpoint.

Links

Get Involved

Contributions are very welcome! Whether it’s bug fixes, new features, documentation improvements, or just feedback — open an issue or PR on GitHub.

And if you build something with Meteor Wormhole, I’d love to hear about it. Drop a comment here and let me know what you’re using it for! :rocket:

1 Like