MCP Server

Connect AI assistants to wish.now via the Model Context Protocol.

Overview

The wish.now MCP server enables AI assistants like Claude Desktop and ChatGPT to create, search, and manage wishes through natural conversation. It runs on Cloudflare Workers for global edge performance.

Tools Available

<200ms

Response Time

Edge

Global Deployment

Claude Desktop Setup

Step 1: Get Your MCP Key

Generate an MCP API key from your wish.now settings page at /mcp-keys.

Step 2: Configure Claude Desktop

Add the following to your Claude Desktop MCP configuration file:

{
  "mcpServers": {
    "wish-now": {
      "url": "https://mcp.soft.house/sse",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Step 3: Restart Claude Desktop

Restart Claude Desktop to load the MCP server. You should see wish.now tools available in the tools menu.

Tool Reference

TOOL create_wish

Create a new wish with AI-powered content moderation and automatic protocol detection.

Parameters

Name	Type	Required	Description
title	string	Yes	Wish title
description	string	No	Detailed description
category	string	No	Wish category
budget_max	number	No	Maximum budget (USD)
location_text	string	No	Location description
budget_type	string	No	"fixed" or "open"

TOOL search_wishes

Search public wishes by keyword, category, or location.

Parameters

Name	Type	Required	Description
query	string	Yes	Search text
category	string	No	Category filter
limit	number	No	Max results (default 10)

TOOL get_status

Check the current status of a wish by ID. Returns status, timeline events, and payment state.

TOOL list_wishes

List the authenticated user's wishes with optional status filtering.

TOOL purchase_offering

Purchase an offering for a wish. Initiates checkout via the appropriate payment protocol (AP2 or ACP).

Example Conversations

Creating a wish

You

I need a dog walker in San Francisco, around $150/month

Claude

I'll create that wish for you.

Using tool: create_wish

title: "Dog walker in San Francisco"

category: "pet-care"

budget_max: 150

location_text: "San Francisco, CA"

Done! Your wish has been created and is pending moderation. It scored 92/100 on safety review and was auto-approved. You can track it at wish.now/wishes/abc123.

Searching wishes

You

Are there any home repair wishes near me?

Claude

Let me search for home repair wishes in your area.

Using tool: search_wishes

query: "home repair"

category: "home-services"

I found 3 home repair wishes near you. The first one is looking for someone to fix a leaky faucet, budget $200...

Protocol Support

The MCP server implements the MCP v2025-11-25 specification with these features:

Tasks Primitive: Async call-now, fetch-later operations for long-running wishes
Sampling with Tools: Server-side agentic loops for wish fulfillment
OAuth Client Credentials: Machine-to-machine authentication
Standardized Tool Naming: Canonical format per SEP-986