Agent beta

Start a gift search from the agent you already use.

Present Agent runs as an MCP tool for Claude Code, Codex, Cursor, and other local agent clients. The beta path calls the hosted API, so you do not need a local product catalog, Shopify credentials, or a model-provider API key to get first value.

Install for Claude Code →Install for Codex Try on web first

What you get

Hosted picks

Five gift recommendations, reasons, and a web picks URL without local data setup.

Optional local context

Opt in to search local Claude/Codex memory for recipient signals when you want richer guesses.

Web fallback

Every agent session returns a link you can open, share, or continue in the browser.

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 github:GuillaumeRacine/present-agent-v3-mar2026

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 github:GuillaumeRacine/present-agent-v3-mar2026 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", "github:GuillaumeRacine/present-agent-v3-mar2026"]
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.

Stripe Agentic Commerce Protocol
Shopify Universal Commerce Protocol
Typed MCP tools: search_gifts, get_recipient, create_checkout.

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 repo guide