Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions plugins/build-web-apps/.app.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
{
"apps": {
"stripe": {
"id": "connector_690ab09fa43c8191bca40280e4563238"
},
"vercel": {
"id": "connector_690a90ec05c881918afb6a55dc9bbaa1"
}
}
}
4 changes: 2 additions & 2 deletions plugins/build-web-apps/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -22,11 +22,11 @@
"ui-review"
],
"skills": "./skills/",
"mcpServers": "./.mcp.json",
"apps": "./.app.json",
"interface": {
"displayName": "Build Web Apps",
"shortDescription": "Build, review, ship, and scale web apps across UI, React, deployment, payments, and databases",
"longDescription": "Use Build Web Apps to review and improve a web app's UI, apply React and Next.js guidance, deploy projects to Vercel, wire up Stripe payments, and design or tune Supabase/Postgres schemas and queries, all with plugin-local Vercel, Stripe, and Supabase MCP support.",
"longDescription": "Use Build Web Apps to review and improve a web app's UI, apply React and Next.js guidance, deploy projects to Vercel, wire up Stripe payments, and design or tune Postgres schemas and queries, with connected Vercel and Stripe apps plus bundled database guidance.",
"developerName": "OpenAI",
"category": "Coding",
"capabilities": [
Expand Down
16 changes: 0 additions & 16 deletions plugins/build-web-apps/.mcp.json

This file was deleted.

17 changes: 8 additions & 9 deletions plugins/build-web-apps/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,15 +11,14 @@ It currently includes these skills:
- `supabase-best-practices`
- `web-design-guidelines`

It is scaffolded to use these plugin-local MCP servers:
It is scaffolded to use these connected apps:

- `stripe`
- `vercel`
- `supabase`

## What It Covers

- deployment and hosting operations through Vercel MCP
- deployment and hosting operations through the Vercel app
- React and Next.js performance guidance sourced from Vercel best practices
- shadcn/ui composition, styling, and component usage guidance
- Stripe integration design across payments, subscriptions, Connect, and Treasury
Expand All @@ -40,10 +39,10 @@ with this shape:
- required plugin manifest
- defines plugin metadata and points Codex at the plugin contents

- `.mcp.json`
- plugin-local MCP dependency manifest
- bundles the Stripe, Vercel, and Supabase MCP endpoints used by bundled
skills
- `.app.json`
- plugin-local app dependency manifest
- points Codex at the connected Stripe and Vercel apps used by the bundled
workflows

- `agents/`
- plugin-level agent metadata
Expand All @@ -55,11 +54,11 @@ with this shape:

## Notes

This plugin is MCP-backed through `.mcp.json` and currently combines:
This plugin is app-backed through `.app.json` and currently combines:

- Vercel deployment workflows
- React and Next.js optimization guidance
- shadcn/ui frontend implementation guidance
- Stripe integration guidance
- Supabase/Postgres optimization guidance
- Supabase/Postgres optimization guidance without a plugin-local Supabase app
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove this one no?

- web design and UI review guidance
17 changes: 4 additions & 13 deletions plugins/build-web-apps/agents/openai.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -7,18 +7,9 @@ interface:

dependencies:
tools:
- type: "mcp"
- type: "app"
value: "stripe"
description: "Stripe MCP server"
transport: "streamable_http"
url: "https://mcp.stripe.com"
- type: "mcp"
description: "Connected Stripe app"
- type: "app"
value: "vercel"
description: "Vercel MCP server"
transport: "streamable_http"
url: "https://mcp.vercel.com"
- type: "mcp"
value: "supabase"
description: "Supabase MCP server"
transport: "streamable_http"
url: "https://mcp.supabase.com/mcp"
description: "Connected Vercel app"
1 change: 0 additions & 1 deletion plugins/hugging-face/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,6 @@
],
"skills": "./skills/",
"apps": "./.app.json",
"mcpServers": "./.mcp.json",
"interface": {
"displayName": "Hugging Face",
"shortDescription": "Inspect models, datasets, Spaces, and research",
Expand Down
8 changes: 0 additions & 8 deletions plugins/hugging-face/.mcp.json

This file was deleted.

7 changes: 7 additions & 0 deletions plugins/vercel/.app.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"apps": {
"vercel": {
"id": "connector_690a90ec05c881918afb6a55dc9bbaa1"
}
}
}
6 changes: 3 additions & 3 deletions plugins/vercel/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -26,11 +26,11 @@
"discord-bot"
],
"skills": "./skills/",
"mcpServers": "./.mcp.json",
"apps": "./.app.json",
"interface": {
"displayName": "Vercel",
"shortDescription": "Build and deploy web apps and agents",
"longDescription": "Bring Vercel ecosystem guidance into Codex with curated skills and the official Vercel MCP server. Packages the upstream vercel/vercel-plugin skills, agents, and commands under the local `vercel` plugin identity for the Codex plugin marketplace.",
"longDescription": "Bring Vercel ecosystem guidance into Codex with curated skills and the connected Vercel app. Packages the upstream vercel/vercel-plugin skills, agents, and commands under the local `vercel` plugin identity for the Codex plugin marketplace.",
"developerName": "Vercel Labs",
"category": "Coding",
"capabilities": ["Interactive", "Write"],
Expand All @@ -40,7 +40,7 @@
"defaultPrompt": [
"Audit this repo for Vercel deployment risks",
"Which Vercel tools fit this app best",
"Help wire Vercel MCP into this workflow"
"Help wire the Vercel app into this workflow"
],
"composerIcon": "./assets/app-icon.png",
"logo": "./assets/app-icon.png",
Expand Down
9 changes: 0 additions & 9 deletions plugins/vercel/.mcp.json

This file was deleted.

5 changes: 3 additions & 2 deletions plugins/vercel/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ This directory packages the upstream [vercel/vercel-plugin](https://github.com/v
## What is included

- `skills/` from the upstream plugin (47 skills with retrieval metadata for Codex discovery)
- `.mcp.json` for the official Vercel MCP server
- `.app.json` for the connected Vercel app
- `vercel.md` ecosystem reference graph
- `agents/` specialist agent definitions
- `commands/` slash command definitions
Expand Down Expand Up @@ -62,7 +62,7 @@ A text-form relational graph covering:
| `turborepo` | Monorepo orchestration, caching, remote caching, --affected, pruned subsets |
| `v0-dev` | AI code generation, agentic intelligence, GitHub integration |
| `vercel-agent` | AI-powered code review, incident investigation, SDK installation, PR analysis |
| `vercel-api` | Vercel MCP Server and REST API — projects, deployments, env vars, domains, logs |
| `vercel-api` | Connected Vercel app and REST API guidance — projects, deployments, env vars, domains, logs |
| `vercel-cli` | All CLI commands — deploy, env, dev, domains, cache management, MCP integration, marketplace |
| `vercel-firewall` | DDoS, WAF, rate limiting, bot filter, custom rules |
| `vercel-flags` | Feature flags, Flags Explorer, gradual rollouts, A/B testing, provider adapters |
Expand Down Expand Up @@ -105,6 +105,7 @@ After installing, skills are discovered automatically via Codex's metadata-based
```text
vercel/
├── .codex-plugin/plugin.json # Plugin manifest
├── .app.json # Connected Vercel app manifest
├── vercel.md # Ecosystem graph + conventions
├── skills/ # 47 skills discovered via SKILL.md metadata
│ ├── agent-browser/
Expand Down
12 changes: 6 additions & 6 deletions plugins/vercel/skills/vercel-api/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: vercel-api
description: Vercel MCP and REST API expert guidance. Use when the agent needs live access to Vercel projects, deployments, environment variables, domains, logs, or documentation through the MCP server or REST API.
description: Vercel app and REST API expert guidance. Use when the agent needs live access to Vercel projects, deployments, environment variables, domains, logs, or documentation through the connected Vercel app or REST API.
metadata:
priority: 7
docs:
Expand Down Expand Up @@ -44,13 +44,13 @@ chainTo:

---

# Vercel API — MCP Server & REST API
# Vercel API — Connected App & REST API

You are an expert in the Vercel platform APIs. This plugin bundles a connection to the **official Vercel MCP server** (`https://mcp.vercel.com`) which gives agents live, authenticated access to Vercel resources.
You are an expert in the Vercel platform APIs. This plugin uses the connected Vercel app for live, authenticated access to Vercel resources, and this skill also covers the direct REST API when connector coverage is not enough.

## MCP Server (Public Beta)
## Connected Vercel App

The plugin's `.mcp.json` configures the official Vercel MCP server using Streamable HTTP transport with OAuth authentication. The MCP server is in **public beta** — read-only in the initial release. Write operations are on the roadmap. Supported clients: Codex, Cursor, and VS Code.
The plugin's `.app.json` points Codex at the connected Vercel app. The linked Vercel documentation still describes the underlying MCP server and REST API, and this skill uses that documentation where it helps explain capabilities and fallback paths.

### Connection

Expand All @@ -64,7 +64,7 @@ On first connection the agent will open a browser-based OAuth flow to grant read

### Available MCP Tools

The Vercel MCP server exposes these tool categories (read-only in initial release):
The connected Vercel app exposes these tool categories:

| Category | Capabilities |
|----------|-------------|
Expand Down