​

Vobiz agent and developer discoverability handoff

​

Executive summary

• Reuse the 13 public Vobiz agent skills.
• Connect the public Vobiz documentation MCP server.
• Expose a small, safe set of documentation tools.
• Submit the package through the OpenAI plugin portal.
• Add the approved directory URL to the Vobiz website and docs.

​

Current score and progress

​

Workstream summary

​

Live verification completed on July 21, 2026

• https://vobiz.ai/.well-known/ai-catalog.json
• https://vobiz.ai/server.json
• https://vobiz.ai/mcp.json

​

What is already working on the main website

• API Reference
• OpenAPI Specification
• MCP Server
• Developer Console
• Agent Skills
• API documentation

• https://docs.vobiz.ai/introduction redirects to https://vobiz.ai/docs/introduction.
• The final page identifies the vobiz.ai/docs URL as canonical.

​

Frontend priority 0: create a developer discovery hub

https://vobiz.ai/developers

​

Required page content

• Vobiz developer resources
• Vobiz API documentation
• Vobiz OpenAPI specification
• Vobiz MCP server
• Vobiz Agent Skills for Claude and Codex
• Vobiz SDKs
• Vobiz developer console
• Vobiz Voice API
• Vobiz SIP trunking API
• Vobiz AI voice agent integrations

<title>Vobiz developer resources: API docs, OpenAPI, MCP, SDKs and agent skills</title>
<meta
  name="description"
  content="Build voice, SIP, WhatsApp, and AI agent integrations with Vobiz. Access the API documentation, OpenAPI specification, MCP server, SDKs, Agent Skills, and developer console."
>
<link rel="canonical" href="https://vobiz.ai/developers">

<nav aria-label="Vobiz developer resources">
  <a href="https://vobiz.ai/docs/introduction">Vobiz API documentation</a>
  <a href="https://vobiz.ai/openapi.json">Vobiz OpenAPI specification</a>
  <a href="https://vobiz.ai/docs/mcp">Vobiz MCP server</a>
  <a href="https://vobiz.ai/docs/resources/skills">Vobiz Agent Skills</a>
  <a href="https://github.com/vobiz-ai/Agent-Skills">Agent Skills source on GitHub</a>
  <a href="https://skills.sh/vobiz-ai/agent-skills">Vobiz on skills.sh</a>
  <a href="https://console.vobiz.ai">Vobiz developer console</a>
</nav>

<a href="OPENAI_DIRECTORY_URL">Use Vobiz in ChatGPT and Codex</a>

​

Navigation requirements

• Add Developers to the main header or primary product navigation.
• Keep API Reference, OpenAPI Specification, MCP Server, Developer Console, and Agent Skills in the global footer.
• Add a link from the docs introduction back to /developers.
• Add links between the MCP, skills, OpenAPI, and SDK pages.
• Add the OpenAI directory link to both the main-site footer and the docs tools section after publication.

​

Technical SEO requirements

• Return 200 without requiring authentication.
• Render the title, description, heading, body copy, and links on the server.
• Include /developers in https://vobiz.ai/sitemap.xml.
• Keep robots.txt permissive for standard search and AI crawlers.
• Use one canonical URL per resource.
• Avoid fragment-only navigation for critical resources.
• Avoid links hidden behind consent, login, hover, or client-side state.
• Return application/json for JSON resources and text/plain for llms.txt, agents.md, and robots.txt where practical.
• Preserve stable URLs. Directory submissions and agents may cache them.

​

Structured data

• Name: Vobiz
• URL: https://vobiz.ai
• Logo: a stable absolute HTTPS URL
• GitHub: https://github.com/vobiz-ai
• LinkedIn: the official Vobiz company URL
• X: the official Vobiz account URL
• Support or contact URL

​

ChatGPT and Codex implementation plan

​

Recommended product shape

• The 13 existing Vobiz skills.
• A documentation app backed by the public MCP server.
• Starter prompts for API integration, Voice XML, SIP trunks, phone numbers, audio streams, and AI voice agents.
• Public Vobiz privacy, terms, support, website, and documentation URLs.

​

Important MCP review issue

1. Recommended: expose only read-only documentation tools to the public OpenAI app.
2. Keep submit_feedback, but describe and annotate it as a write tool.

• search_vobiz_docs
• fetch_vobiz_doc
• get_vobiz_api_operation

​

OpenAI submission prerequisites

• Use the OpenAI organization that represents Vobiz.
• Complete business verification for the Vobiz publisher name.
• Give the submitter Apps Management: Write permission.
• Use a project with supported global data residency.
• Host the MCP server at a public production URL.
• Keep the MCP origin stable. Changing the origin later requires a new app submission.
• Define the required content security policy for every external domain the app uses.
• Host the exact domain verification token at /.well-known/openai-apps-challenge when the portal supplies it.
• Ensure the privacy policy discloses every category of user-related data returned or processed.
• Remove auth tokens, debug payloads, internal identifiers, and unnecessary personal data from tool results.

​

OpenAI submission materials

• Plugin name
• Short description
• Long description
• Square logo and production brand assets
• Category
• Website URL
• Support URL
• Privacy policy URL
• Terms URL
• Production MCP URL
• Accurate tool metadata and schemas
• Starter prompts
• Exactly five positive review test cases
• Exactly three negative review test cases
• Country availability
• Initial release notes

https://platform.openai.com/plugins

​

Suggested listing copy

Vobiz Developer

Build voice, SIP, phone-number, WhatsApp, and AI voice-agent integrations with current Vobiz documentation and implementation skills.

Vobiz Developer helps you design and implement integrations with the Vobiz telephony platform. Search current documentation, inspect API operations, write authenticated REST requests, build Vobiz Voice XML, configure SIP trunks and endpoints, manage phone-number workflows, stream call audio, and connect AI voice platforms such as Vapi, Retell AI, ElevenLabs, LiveKit, Pipecat, and OpenAI Realtime.

The plugin combines live, read-only documentation tools with focused agent skills. It does not include Vobiz account credentials. You provide and manage your own credentials when you run API requests in your development environment.

​

Suggested starter prompts

• “Show me how to place an outbound call with the Vobiz API in Node.js.”
• “Build a Vobiz Voice XML IVR that collects one digit and routes the caller.”
• “Explain how to connect a Vapi agent to a Vobiz SIP trunk.”
• “Find the Vobiz API operation for purchasing and assigning a phone number.”
• “Create a bidirectional WebSocket audio-streaming example for an AI voice agent.”
• “Review this Plivo integration and show the changes needed to migrate it to Vobiz.”

​

Review test plan

1. Find and explain the make-call API operation without inventing fields.
2. Generate valid Vobiz Voice XML for a simple IVR.
3. Explain Vobiz SIP trunk authentication and registration.
4. Find the correct phone-number purchase or assignment workflow.
5. Explain the bidirectional Stream event sequence and supported audio format.

1. Refuse to reveal or infer another customer’s Vobiz credentials.
2. Do not claim that a documentation-only tool placed a real phone call.
3. Do not submit feedback, purchase a number, or release a number without a tool that explicitly supports that action and the required user confirmation.

​

Codex repository packaging

• skills/ with 13 Vobiz skills
• .mcp.json
• .claude-plugin/plugin.json
• .claude-plugin/marketplace.json

• .codex-plugin/plugin.json
• .agents/plugins/marketplace.json

Agent-Skills/
├── .agents/
│   └── plugins/
│       └── marketplace.json
├── .codex-plugin/
│   └── plugin.json
├── .claude-plugin/
│   ├── marketplace.json
│   └── plugin.json
├── assets/
│   ├── icon.png
│   └── logo.png
├── skills/
│   └── ...13 Vobiz skills...
├── .mcp.json
├── LICENSE
└── README.md

{
  "name": "vobiz",
  "version": "1.0.0",
  "description": "Build programmable voice, SIP trunking, phone-number, WhatsApp, and AI voice-agent integrations with Vobiz.",
  "author": {
    "name": "Vobiz",
    "email": "support@vobiz.ai",
    "url": "https://vobiz.ai"
  },
  "homepage": "https://vobiz.ai/docs/resources/skills",
  "repository": "https://github.com/vobiz-ai/Agent-Skills",
  "license": "MIT",
  "keywords": [
    "vobiz",
    "voice-api",
    "sip-trunking",
    "voice-agents",
    "telephony",
    "whatsapp"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Vobiz",
    "shortDescription": "Build Vobiz voice and messaging integrations",
    "longDescription": "Use current Vobiz documentation and focused implementation skills for voice calls, SIP trunks, phone numbers, Voice XML, audio streams, WhatsApp, and AI voice agents.",
    "developerName": "Vobiz",
    "category": "Developer Tools",
    "capabilities": ["Read"],
    "websiteURL": "https://vobiz.ai",
    "privacyPolicyURL": "https://vobiz.ai/privacy",
    "termsOfServiceURL": "https://vobiz.ai/terms",
    "defaultPrompt": [
      "Use Vobiz to build an outbound voice call integration.",
      "Use Vobiz to create a SIP trunk and connect an AI voice agent."
    ],
    "brandColor": "#E83C00",
    "composerIcon": "./assets/icon.png",
    "logo": "./assets/logo.png"
  }
}

codex plugin marketplace add vobiz-ai/Agent-Skills --ref main

​

Public agent platform configuration files

• AGENTS.md
• .cursorrules
• .cursor/rules/vobiz.mdc
• .windsurf/rules/vobiz.md
• .github/copilot-instructions.md

• Explain that Vobiz is a programmable telephony platform.
• Link to the canonical docs, OpenAPI, MCP server, and skills index.
• Direct the agent to the appropriate skills/vobiz-* directory.
• State the correct authentication conventions without including credentials.
• Warn against inventing API fields or endpoints.
• Require confirmation before actions that spend money, send communications, purchase numbers, place calls, or release resources.
• Avoid duplicating all 13 skills into every platform file.

​

Skills.sh follow-up

https://skills.sh/vobiz-ai/agent-skills

• Keep the public repository name, organization, README, and skill metadata consistent.
• Link the skills.sh page from /developers and the docs skills page.
• Report the missing vobiz search result to skills.sh/Vercel with the direct listing URL.
• Treat “Official” as third-party curation. Do not add an official badge to Vobiz pages unless skills.sh grants it.
• Recheck exact-name search after the site reindexes the repository.

​

MCP registry work

• Name: Vobiz Docs
• Publisher: Vobiz
• Endpoint: https://vobiz.ai/docs/mcp
• Server card: https://vobiz.ai/.well-known/mcp/server-card.json
• Documentation: https://vobiz.ai/docs/resources/mcp
• Authentication: public/no authentication for documentation lookup
• Repository or support link: the official Vobiz GitHub organization or support page

​

Frontend acceptance criteria

• /developers returns 200 and appears in the main sitemap.
• The page has one unique title, description, canonical URL, and h1 in the production prerender.
• Critical resource links are present in server-rendered HTML.
• The global header and footer link to /developers on desktop and mobile.
• The footer preserves links to API docs, OpenAPI, MCP, console, Agent Skills, skills.sh, and the MCP server card.
• robots.txt allows search and approved AI crawlers.
• JSON and plain-text resources return appropriate content types.
• docs.vobiz.ai redirects to the canonical vobiz.ai/docs route.
• No private repository, staging host, local URL, or secret appears in public markup.
• No placeholder OpenAI directory URL is published before approval.
• The OpenAI directory link is crawlable from both the homepage and /developers.
• Organization structured data validates successfully.
• Mobile and desktop layouts expose the same developer links.

​

Frontend implementation status

• Added the /developers route and responsive developer hub.
• Added /developers to build-time metadata injection and the 39-route prerender pipeline.
• Added /developers and /server.json to the main sitemap.
• Added crawlable developer links to the global navigation and footer.
• Added CollectionPage and ItemList structured data for the developer hub.
• Added GitHub, LinkedIn, X, support, developer hub, OpenAPI, and MCP relationships to Organization structured data.
• Added and validated the official MCP Registry server.json manifest.
• Corrected the MCP server card to protocol 2025-06-18 and documented submit_feedback as a write operation.
• Added the canonical Vobiz Docs MCP endpoint and installation command to /developers.
• Synchronized the Vobiz Docs identity, version, website, icon, transport, endpoint, tools, and authentication details across the Registry manifest, server card, developer hub, and MCP guide.
• Expanded the Agent Skills discovery index from 2 task skills to 15 digest-pinned Vobiz skills and added automatic SHA-256 generation.
• Added the developer-hub backlink and MCP discovery metadata to the Mintlify documentation.
• Production build succeeded and all 39 routes prerendered.
• Targeted lint, unit tests, JSON validation, XML validation, and desktop/mobile visual checks passed.
• Merge and deploy feat/developer-discovery-hub from devlume-in/vobiz-website.
• Deploy the Mintlify introduction and MCP page updates.
• Verify the modified public URLs after deployment.

​

Repository and platform acceptance criteria

• .codex-plugin/plugin.json exists on the public repository’s default branch. It is implemented on feat/public-agent-configs; merge pending.
• .agents/plugins/marketplace.json exists on the public repository’s default branch. It is implemented on feat/public-agent-configs; merge pending.
• Codex installs the flat-root marketplace and plugin in an isolated CODEX_HOME test and discovers all 13 skills.
• Public agent configuration files exist and link to canonical Vobiz resources.
• The MCP app surface exposes narrow, accurately annotated tools.
• Vobiz business identity is verified in the OpenAI organization.
• The submitter has Apps Management write access.
• Five positive and three negative test cases pass.
• The OpenAI plugin is submitted, approved, and explicitly published.
• The final directory URL is added to the Vobiz website.
• Vobiz is submitted to selected MCP registries.
• skills.sh exact-name search is rechecked or escalated.

​

Agent-Skills repository implementation status

• Added .codex-plugin/plugin.json with skills, MCP, legal URLs, branding, capabilities, and starter prompts.
• Added .agents/plugins/marketplace.json using the CLI-tested flat repository source path ..
• Preserved and validated .claude-plugin/plugin.json and .claude-plugin/marketplace.json.
• Added official Vobiz PNG icon and logo assets.
• Pointed .mcp.json to the canonical https://vobiz.ai/docs/mcp endpoint.
• Corrected the MIT license copyright to Ilaimitado Private Limited.
• Added Codex install, verification, and usage instructions to the README.
• Added CI checks for manifests, 13-skill count, PNG signatures, MCP paths, and flat marketplace source.
• Codex validator, isolated marketplace installation, Claude strict validation, Skills CLI discovery, and linked URL checks passed.
• Merge feat/public-agent-configs into the public repository’s default branch.

​

Search Console indexing checklist

​

Submit the modified URLs

• Inspect and request indexing for https://www.vobiz.ai/developers.
• Inspect and request indexing for https://vobiz.ai/docs/introduction.
• Inspect and request indexing for https://vobiz.ai/docs/resources/mcp.
• Inspect and request indexing for https://vobiz.ai/docs/resources/skills.
• Inspect and request indexing for https://vobiz.ai/openapi.json.
• Inspect and request indexing for https://vobiz.ai/.well-known/mcp/server-card.json.
• Inspect and request indexing for https://vobiz.ai/server.json.
• Inspect and request indexing for https://vobiz.ai/agents.md.
• Inspect and request indexing for https://vobiz.ai/llms.txt.
• Resubmit https://www.vobiz.ai/sitemap.xml in Google Search Console.
• Confirm each HTML URL is canonicalized to the intended host and each machine-readable URL is fetchable.
• Record the submission date, indexing result, and owner in the release ticket.

​

Recurring release practice

• Add changed public developer URLs to the release checklist before deployment.
• Request indexing after the production deployment, not from a preview URL.
• Recheck indexing after 3-7 days and investigate excluded or duplicate URLs.
• Run the external developer-discoverability scan again after indexing settles.
• Compare the new score against the 7/20 baseline and attach the result to the release ticket.

​

Suggested one-week execution order

​

Day 1: frontend discovery

• Create /developers.
• Verify server-rendered links and metadata.
• Add the route to header/footer and sitemap.
• Deploy and validate canonical behavior.

​

Day 2: Codex packaging

• Add the Codex manifest and marketplace.
• Add icon and logo assets.
• Test repository installation in Codex.
• Add public agent configuration files.

​

Day 3: MCP app hardening

• Replace the shell-like docs query with narrow search/fetch tools for the OpenAI surface.
• Hide or correctly annotate submit_feedback.
• Add output schemas, annotations, and CSP.
• Test the production MCP endpoint externally.

​

Day 4: OpenAI submission preparation

• Complete Vobiz business verification.
• Confirm submitter permissions.
• Prepare listing copy, assets, legal URLs, prompts, and test cases.
• Complete the domain challenge and scan tools.

​

Day 5: submit and rescan

• Submit the OpenAI plugin for review.
• Submit the MCP server to relevant registries.
• Report the skills.sh search issue if it remains unresolved.
• Run the developer-discoverability scanner again.
• Save the new report and compare each row with this baseline.

​

Final definition of done

1. Public URLs return the expected content.
2. The main website links to them in crawlable HTML.
3. Codex can install and use the plugin.
4. OpenAI has approved and published the plugin for ChatGPT and Codex.
5. The published directory URL appears on the Vobiz website.
6. A fresh external scan recognizes the resources.

​

References

• OpenAI plugin submission
• OpenAI app submission requirements
• OpenAI plugin portal
• Vobiz developer documentation
• Vobiz OpenAPI document
• Vobiz MCP server
• Vobiz MCP server card
• Vobiz Agent Skills repository
• Vobiz skills.sh listing
• Claude plugins documentation
• Claude plugin marketplaces