Skip to content

unitedideas/bringyour-mcp

Repository files navigation

Bring Your AI MCP

Public metadata repository for the Bring Your AI remote MCP server.

Agent surface proof

Bring Your AI moves agent-harness context between tools, starting with Claude Code to Codex. The paid CLI runs locally on the user's machine. This hosted MCP endpoint is intentionally no-data: it only exposes preview, target-listing, and install-command tools. It does not accept harness files, generated memories, project files, API keys, GitHub handles, or file contents.

Endpoint

https://bringyour.ai/mcp

Transport: streamable HTTP.

Official registry name:

ai.bringyour/bringyour

Manifest:

https://bringyour.ai/.well-known/mcp.json

Tools

  • preview_move - Preview supported source and destination harness moves without receiving user files.
  • preview_build_setup - Preview first-setup generation options without receiving user files or work history.
  • install_local_cli - Return local CLI installation commands and verification steps.
  • list_targets - List supported source and destination agent harnesses.
  • list_products - Return the buyable local CLI products and checkout routes.
  • quote_lifetime_license - Return a deterministic quote for the lifetime license without receiving harness files.
  • start_checkout - Start the Stripe-hosted checkout handoff for a selected license tier.

Local CLI Flow

curl -fsSL https://bringyour.ai/install.sh | sh
bringyour preview --from claude-code --to codex
bringyour migrate --from claude-code --to codex --policy merge

Codex import validation pages:

Agent-readable buying surfaces:

No-secret smoke payloads for agent buyers and directory reviewers:

  • examples/agent-discovery/directory-review-proof.json - single machine-readable proof bundle for directory reviewers and agent buyers.
  • examples/agent-discovery/mcp-tools-call.json - JSON-RPC tools/list payload for the no-data remote MCP endpoint.
  • examples/agent-discovery/quote-request.json - quote request shape for the local CLI lifetime license.
  • examples/agent-discovery/checkout-request.json - checkout handoff request shape with placeholder return URLs.

Manual Codex-to-Codex sync:

bringyour sync export --root ~/.codex --out ./bya-codex-sync
bringyour sync plan --in ./bya-codex-sync --root ~/.codex
bringyour sync apply --in ./bya-codex-sync --root ~/.codex

Privacy Boundary

The remote MCP server must not receive private harness data. Actual migration and sync work happens through the local CLI or local MCP server. The hosted endpoint exists for discovery, preview, and install handoff.

Public Codex Artifacts

This repo also carries installable, no-secret public artifacts for auditing migrated Codex setups:

  • .codex-plugin/plugin.json - Codex plugin manifest that exposes the migration-auditor skill as an installable plugin.
  • skills/bringyour-migration-auditor/SKILL.md - Codex skill for checking AGENTS.md/CLAUDE.md scope, hooks, MCP config, skills, secrets, and validation notes after a migration.
  • agents/harness-migration-auditor.toml - Codex subagent config for the same read-only audit path.
  • .github/workflows/agent-surface-proof.yml - public CI proof that the hosted discovery, commerce, and MCP handoff surfaces stay callable without secrets.
  • examples/github-actions/bringyour-agent-surface-check.yml - reusable workflow sample for teams that want a scheduled discovery, MCP, quote, and checkout handoff check before relying on Bring Your AI during a Claude Code to Codex move.
  • examples/github-actions/codex-import-audit.yml - reusable workflow sample for teams that want a Codex import audit record before allowing Codex to edit source after a Claude Code migration.
  • examples/github-actions/claude-codex-continuity-check.yml - pull-request workflow sample that inventories AGENTS.md, CLAUDE.md, .claude, .codex, and MCP config changes, then writes Codex validation notes before source edits.
  • examples/github-actions/mcp-config-migration-check.yml - pull-request workflow sample that inventories MCP config surfaces, verifies the public no-data checklist, and writes target-side MCP validation notes.
  • examples/agent-discovery/*.json - no-secret proof and payload examples for directory review, MCP tools/list, quote, and checkout smoke checks.
  • examples/codex-import-audit/sample-report.json - machine-readable example audit report for Claude Code to Codex import review.
  • examples/mcp-config-migration/checklist.json - agent-readable MCP config migration checklist that preserves the no-data remote boundary.

Directory reviewers can use the latest agent-surface-proof workflow run as public evidence that the MCP endpoint, agent manifests, commerce surfaces, quote endpoint, and checkout handoff are live without receiving private harness data.

Links

Releases

No releases published

Packages

 
 
 

Contributors