Many Worlds MCP: How To

This page explains how to connect to the Many Worlds MCP endpoint and use the core research tools.

Endpoint

• URL: https://manyworldsresearch.com/mcp
• Auth: OAuth bearer token or personal MCP bearer token

Keep tokens secret. Do not paste them into chats, screenshots, or logs.

Authentication options

You can connect in either of these ways:

1. OAuth connector

   • Best for ChatGPT connectors and other MCP clients that support OAuth.
   • The server publishes MCP OAuth discovery metadata and supports Dynamic Client Registration.
   • ChatGPT can create a connector directly against https://manyworldsresearch.com/mcp.

2. Personal MCP token

   • Best for local tools, scripts, and clients where you want a static bearer token.
   • Tokens are created from your Many Worlds account page.

Option 1: Use OAuth

For ChatGPT or another OAuth-capable MCP client:

1. Point the client at https://manyworldsresearch.com/mcp.
2. Choose OAuth authentication.
3. Let the client discover the OAuth metadata automatically.
4. Sign in and approve access when redirected.

Notes:

• The server exposes MCP protected resource metadata and authorization server metadata.
• OAuth is proxied through Many Worlds, which validates the client registration and then completes login via Auth0.
• Access tokens issued through OAuth should be sent as Authorization: Bearer ... on MCP requests.

Option 2: Create a personal MCP token

1. Sign in to your Many Worlds account.
2. Open Account: https://manyworldsresearch.com/account
3. In MCP token, choose a token lifetime (TTL) and create a new token.
4. Copy the token immediately and store it in your secret manager.

Notes:

• The full token is shown once at creation time.
• Creating a new token revokes your previous token.
• You can revoke the current token anytime from the Account page.

Use it in requests as:

Authorization: Bearer YOUR_TOKEN

What you can do

The MCP endpoint supports:

• list_research — list simulation research instances
• search_research — find research by team/company/event text
• list_research_documents — list available documents for one instance
• get_research_document — fetch one document by document_id

Common document IDs:

• metadata_json
• odds_json
• report_html
• mesh_json

Recommended workflow

1. Use search_research or list_research to find an instance.
2. Call list_research_documents for that instance.
3. Fetch only the document you need with get_research_document.
4. Start with metadata_json for quick summaries; use report_html and mesh_json for deep analysis.

Download skill file

• Download Many Worlds MCP skill file (.md)

If your browser opens it instead of downloading, right-click and choose Save link as....