Skip to content

sttruji/mundane

v1.0.0Apache-2.0

Hire ID-verified local people for in-person tasks, with payment held until you approve the proof.

Mundane in OpenAI's plugin directory (ChatGPT and Codex)

This folder is the package uploaded to OpenAI's plugin directory, in the portable Agent Plugins format. It is not the plugin in ../plugin/:

openai-plugin/ (this folder)plugin/
Installed fromOpenAI's directory, in ChatGPT or Codexsttruji/mundane-mcp marketplace, in Claude Code or Codex
Endpointhttps://api.mundane.market/chatgpt/mcphttps://api.mundane.market/mcp
Sign-inOAuth: the customer connects their Mundane accountan agent API key
Toolsthe customer-facing subsetall of them
Skillshire-local-help, follow-up-and-reviewmundane

Install one or the other, not both: each one is a separate Mundane connection with its own tools, and an agent with both sees the shared tools twice.

Building the upload

python scripts/build_openai_plugin.py

writes dist/mundane-openai-plugin-<version>.zip holding only plugin.json, mcp.json, the skills and the icons; this README stays out of it. tests/test_openai_plugin.py validates the manifests against the Agent Plugins 1.0.0 schemas (vendored in tests/schemas/) and OpenAI's listing limits, and checks the ZIP's exact contents.

Never put credentials in this folder. Reviewer credentials go in the submission form's review details, never in the package.

The auth declaration

mcp.json declares OAuth with a Client ID Metadata Document as OpenAI's packaging page shows it, under the server's extensions.com.openai.auth. The Agent Plugins 1.0.0 schema doesn't list extensions on a server yet, so the test validates the rest and pins that one key. The portal also discovers the OAuth server from /.well-known/oauth-protected-resource on the endpoint; after uploading, check that it imported OAuth with CIMD and nothing else.