World Developer Docs

The Developer Portal MCP lets AI assistants create apps, configure World ID, manage Mini App metadata, upload app store assets, and submit apps for review. It authenticates with a developer portal team API key. Treat that key like a secret: anyone with access to it can make changes to apps in that team.

Endpoint

https://developer.world.org/api/mcp

Create an API key

Open the Developer Portal.
Select your team.
Go to API keys.
Create or reset an API key.
Copy the generated key immediately. It is shown once.

Developer portal API keys start with api_.

Connect your client

Replace api_... with the API key you copied from the Developer Portal.

Claude Code
Codex
Cursor
VS Code

claude mcp add world-developer-portal \
  https://developer.world.org/api/mcp \
  --transport http \
  --scope project \
  --header "Authorization: Bearer api_..."

codex mcp add world-developer-portal \
  --env WORLD_DEVELOPER_API_KEY=api_... \
  -- npx -y mcp-remote https://developer.world.org/api/mcp \
    --transport http-only \
    --header 'Authorization:Bearer ${WORLD_DEVELOPER_API_KEY}'

Add this to .cursor/mcp.json:

{
  "mcpServers": {
    "world-developer-portal": {
      "url": "https://developer.world.org/api/mcp",
      "headers": {
        "Authorization": "Bearer api_..."
      }
    }
  }
}

Add this to .vscode/mcp.json:

{
  "servers": {
    "world-developer-portal": {
      "type": "http",
      "url": "https://developer.world.org/api/mcp",
      "headers": {
        "Authorization": "Bearer api_..."
      }
    }
  }
}

Available tools

Tool	Purpose
`get_team_context`	List your team’s apps and status.
`get_app_config`	Fetch app, World ID, Mini App, and app store configuration.
`create_app`	Create an external World ID app or Mini App.
`configure_world_id`	Create a managed World ID 4.0 relying party for an app.
`get_world_id_signing_key`	Fetch the current signer address. Private keys are not returned.
`rotate_world_id_signing_key`	Generate or set a new World ID signing key. The private key is returned once.
`get_world_id_registration_status`	Fetch and sync World ID registration status from the registry contracts.
`create_world_id_action`	Create or update a World ID action for an app.
`configure_mini_app`	Update Mini App portal settings, app store metadata, and permissions.
`upload_app_image`	Upload logo, hero, content card, meta tag, or showcase images and patch app metadata.
`submit_app_for_review`	Submit an app for review after explicit confirmation.

Recommended flow

Start every session by asking the assistant to inspect the team:

Use the Developer Portal MCP to get my team context. If there is no app for this project, create one.

For an external World ID app:

Create a production external World ID app named Example, configure World ID, create an action called verify-account, and tell me which environment variables to add.

For a Mini App:

Create a Mini App named Example, fill the non-image app store metadata, upload the logo, content card, and showcase images I provide, and submit it for review after confirming the final values with me.

Images

Use upload_app_image for app store images. It uploads the image and stores the correct filename in the matching metadata field. The tool accepts either:

source_url: a public HTTPS URL to a PNG or JPEG.
image_base64: base64-encoded PNG or JPEG bytes for local files.

Use configure_mini_app for Mini App text, links, categories, permissions, countries, and languages. Use upload_app_image for logo, content card, meta tag, hero, and showcase assets. Review submission still requires image metadata. Upload the required images before calling submit_app_for_review:

upload_app_image { app_id, image_type: "logo", image_base64 | source_url }
upload_app_image { app_id, image_type: "content_card", image_base64 | source_url }
upload_app_image { app_id, image_type: "showcase_1", image_base64 | source_url }

Security notes

Store generated World ID private keys immediately. They are returned once and are not recoverable from the portal.
Use a separate API key per local agent or project when possible.
Delete or rotate API keys that are no longer needed.
Confirm destructive actions before asking the assistant to rotate a signer key or submit an app for review.

Overview

World MCP

Developer Portal MCP

Endpoint

Create an API key

Connect your client

Available tools

Recommended flow

Images

Security notes

​Endpoint

​Create an API key

​Connect your client

​Available tools

​Recommended flow

​Images

​Security notes

Endpoint

Create an API key

Connect your client

Available tools

Recommended flow

Images

Security notes