Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.world.org/llms.txt

Use this file to discover all available pages before exploring further.

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

  1. Open the Developer Portal.
  2. Select your team.
  3. Go to API keys.
  4. Create or reset an API key.
  5. 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 mcp add \
  --transport http \
  --scope project \
  --header "Authorization: Bearer api_..." \
  world-developer-portal \
  https://developer.world.org/api/mcp

​
Available tools

ToolPurpose
get_team_contextList your team’s apps and status.
get_app_configFetch app, World ID, Mini App, and app store configuration.
create_appCreate an external World ID app or Mini App.
configure_world_idCreate a managed World ID 4.0 relying party for an app.
get_world_id_signing_keyFetch the current signer address. Private keys are not returned.
rotate_world_id_signing_keyGenerate or set a new World ID signing key. The private key is returned once.
get_world_id_registration_statusFetch and sync World ID registration status from the registry contracts.
create_world_id_actionCreate or update a World ID action for an app.
configure_mini_appUpdate Mini App portal settings, app store metadata, and permissions.
upload_app_imageUpload logo, hero, content card, meta tag, or showcase images and patch app metadata.
submit_app_for_reviewSubmit an app for review after explicit confirmation.
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.