Update to current Orbit API and bundle Orbit's MCP server - #1
Open
avdev4j wants to merge 4 commits into
Open
Conversation
The endpoint moved from fabric-gateway.postmanlabs.com/api/search to api.buildwithorbit.ai/v1/search. Corrected the parameters against the published OpenAPI spec and verified both endpoints live: - limit/cursor are query parameters, not body fields; q is the only accepted body field (max 512 chars) and unknown fields return 400 - meta.nextCursor is absent on the last page, not null - results carry resourceType (plus provider/product from the live API) - pagination caps at 40 results per query Also adds the /v1/integrate endpoint, which turns selected search results into a task brief covering auth, base URLs, and request steps. Co-Authored-By: Claude <noreply@anthropic.com>
Ships .mcp.json so installing the plugin wires up Orbit's search and integrate tools with no user setup (HTTP transport, no auth). The skill now calls those tools instead of constructing curl commands, which moves the API contract server-side — Orbit can change parameters without breaking installed copies of the plugin. The skill keeps everything that is actually this plugin's value: capability decomposition, reading "Not supported" lines as design gaps, iteration, and saving the blueprint to orbit-output/. references/orbit-api.md is retained as a documented REST fallback for when the MCP server is unreachable. Verified both tools live against mcp.buildwithorbit.ai; their schemas also surface two constraints missing from the published OpenAPI spec: integrate caps resources at 10, and both tools accept an optional clientName for usage analytics. Co-Authored-By: Claude <noreply@anthropic.com>
Claude Code only reads .claude-plugin/plugin.json; the root-level plugin.json was silently ignored (`claude plugin validate` reported "Validating components" rather than a manifest). The plugin name would have fallen back to the directory name, making the skill /orbit-claudecode-plugin:discover and the MCP tools mcp__plugin_orbit_claudecode_plugin_orbit__*, which would not have matched the allowed-tools entries in SKILL.md. Also drops the "skills" field (a Codex convention; Claude Code auto-discovers skills/ at the plugin root) and adds author/homepage. Adds .claude-plugin/marketplace.json so the repo is installable as a marketplace, matching the pattern already used by devrel-claude-code-skills. Verified end-to-end: plugin installs as orbit@orbit-marketplace, the bundled MCP server reports plugin:orbit:orbit connected, and /orbit:discover resolves mcp__plugin_orbit_orbit__search and completes a real search plus integration brief. Narrows the integrate guidance: the schema allows 10 resources, but a 5-resource call returned a one-line restatement instead of a brief while a 2-resource call returned the full document, so the skill now advises several focused calls. Co-Authored-By: Claude <noreply@anthropic.com>
`claude plugin add` is not a subcommand. Installing from a repo takes two steps: register the marketplace, then install the plugin from it. Also documents --plugin-dir for local development. Co-Authored-By: Claude <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The skill was pointing at
fabric-gateway.postmanlabs.com/api/search, which no longer exists. Orbit's API is now atapi.buildwithorbit.ai/v1/search, documented at buildwithorbit.ai.Rather than just swap in the new URL and wait for the next move, this bundles Orbit's MCP server so the API contract lives server-side. Orbit can change its parameters without breaking installed copies of the plugin.
What changed
Bundles the MCP server. New
.mcp.jsonpoints athttps://mcp.buildwithorbit.ai/mcp(HTTP transport, no auth). Installing the plugin now wires up thesearchandintegratetools — noclaude mcp add, no API key.Skill drives the tools instead of curl.
SKILL.mdcallsmcp__plugin_orbit_orbit__search/__integrateand keeps everything that is actually this plugin's value: capability decomposition, readingNot supported:lines as design gaps, iteration, saving the blueprint toorbit-output/.Adds
/v1/integrate. Turns chosen endpoints into a task brief covering auth requirements, base URLs, ordered request steps, and gotchas. Wired into the README's design process as step 5.Corrects the parameters. The old reference had several wrong:
cursorlimitq400nextCursorstring | nullresourceTyperesourceType; live API also returnsprovider/productKeeps a REST fallback.
references/orbit-api.mdis rewritten against the published OpenAPI spec and retained for sessions where the MCP tools are unavailable.Verification
Probed the MCP server directly over JSON-RPC (
initialize→tools/list→tools/call) and called both REST endpoints live. The tool schemas surfaced two constraints missing from the published OpenAPI spec, now documented:integratecapsresourcesat 10 itemsclientNamefor anonymous usage analyticsAlso folded in Orbit's own query guidance from the tool description, since it materially affects result quality: include the provider name, one intent per call, no
OR-separated queries.Not verified
The scoped tool name
mcp__plugin_orbit_orbit__searchis derived from the documentedmcp__plugin_<plugin>_<server>__<tool>format, not observed from a real install. Worth one/orbit:discoverrun against the installed plugin to confirm the tools resolve — ifallowed-toolsblocks them, that name is the thing to check.Generated with Claude Code