MCP · agent beta

Add gift intelligence to the agent you already use.

Present Agent runs as an MCP tool. The hosted beta calls our API directly — no local product catalog, Shopify credentials, or model-provider API key required to get first value.

Browse clients ↓Try on web first

Supported clients

Install in your client

Live

Claude Code

User-scoped MCP server. Call present_find_gift from any project.

Hosted serverPicks + web URLOptional local context
Install →
Live

Codex

One command adds Present Agent to ~/.codex/config.toml.

Hosted serverPicks + web URLOptional local context
Install →
Coming soon

Cursor

MCP support is being validated. Join the list to get the install command first.

Hosted serverPicks + web URLComing soon
Notify me
Coming soon

VS Code

Native MCP client support in VS Code is on the roadmap.

Hosted serverPicks + web URLComing soon
Notify me
Coming soon

ChatGPT

Connector + Apps SDK surface planned for the hosted API.

Hosted serverPicks + web URLComing soon
Notify me
Coming soon

Gemini CLI

Local agent context bridge planned for Gemini's CLI.

Hosted serverPicks + web URLComing soon
Notify me

Claude Code

Run this once. It installs a user-scoped MCP server, then Claude Code can call present_find_giftfrom any project.

claude mcp add present-agent --transport stdio --scope user \
  -e PRESENT_AGENT_CLIENT=claude-code \
  -- npx -y present-agent-mcp

Then ask Claude: Find a gift for my sister's birthday under $100. She just got into pottery.

Codex

Run this once. It adds Present Agent to ~/.codex/config.toml. Restart Codex and ask for a gift recommendation.

npx -y present-agent-mcp setup codex --local-context

The installer writes this MCP block. Use --dry-run to preview it without changing files.

[mcp_servers.present-agent]
command = "npx"
args = ["-y", "present-agent-mcp"]
env = { PRESENT_AGENT_CLIENT = "codex", PRESENT_ENABLE_LOCAL_AGENT_CONTEXT = "1" }

Optional context mode

By default the hosted beta only uses what you tell the tool. To let it inspect local Claude/Codex/Gemini text context for the named recipient, add this environment variable and pass useAgentContext=truein the tool call.

PRESENT_ENABLE_LOCAL_AGENT_CONTEXT=1

Secret-looking paths and lines are skipped. The API receives compact preference, need, and constraint hints, not raw files.

Expected first run

You: Find a gift for my sister's birthday under $100. She just got into pottery.
Present Agent:
{
  "mode": "hosted",
  "picksUrl": "https://presentagent.vip/picks/...",
  "recommendations": [
    { "slot": "top_pick", "name": "...", "whyThisFits": "..." }
  ]
}

Built on open standards.

Don't see your client?

Request support for your agent.

Cursor, VS Code, ChatGPT, and Gemini CLI are on the roadmap. Tell us which client you use and we'll send the install command the moment it ships.

Prefer GitHub? Open a client request.

Need the full local mode?

The full repo-backed MCP server still exists for catalog development and internal QA. Use it when you need local SQLite, Shopify operations, card generation, delivery marking, or direct data-pipeline work.

Read the MCP docs