pitchiq-mcp

Search PitchIQ's podcast directory (ListenNotes-indexed). Returns matching shows with title, host, listener tier (small/mid/large), category, and cover image. Useful for finding podcasts an agent should pitch the user onto.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text search term (matches title + description)."
    },
    "listener_tier": {
      "type": "string",
      "enum": [
        "small",
        "mid",
        "large"
      ],
      "description": "Filter by audience size bucket. PitchIQ tiers shows as small / mid / large."
    },
    "category": {
      "type": "string",
      "description": "Filter by category (free-text; varies by source)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  }
}

Search PitchIQ's global Steam-curator index by name, tag, language, and audience size — for an agent marketing a game/product into a niche. Returns curator name, Steam URL, follower + review counts, and tags. x402-payable; no PAT required.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text match on the curator's name."
    },
    "tag": {
      "type": "string",
      "description": "Filter by a curation tag (e.g. 'Indie', 'Strategy', 'RPG')."
    },
    "language": {
      "type": "string",
      "description": "Filter by language (e.g. 'english')."
    },
    "min_followers": {
      "type": "integer",
      "minimum": 0,
      "description": "Minimum follower count."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  }
}

Search PitchIQ's global Twitch/YouTube creator index by name, category, language, audience size, and whether they accept review keys — for an agent seeking creators to cover a game/product. Returns name, platform handles, followers, avg concurrent viewers, category, and top games. x402-payable; no PAT required.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text match on the creator's display name."
    },
    "category": {
      "type": "string",
      "description": "Filter by primary category."
    },
    "language": {
      "type": "string",
      "description": "Filter by language."
    },
    "tier": {
      "type": "string",
      "enum": [
        "small",
        "mid",
        "large"
      ],
      "description": "Audience-size tier."
    },
    "min_followers": {
      "type": "integer",
      "minimum": 0,
      "description": "Minimum follower count."
    },
    "accepts_keys": {
      "type": "boolean",
      "description": "Only creators who accept review keys."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  }
}

Book a confirmed guest slot on a PitchIQ host's PUBLIC booking calendar (Calendly-style). Outcome-priced — you pay per confirmed booking. Re-checks slot availability, sends the confirmation email, and pushes to the host's Google Calendar when connected. Find bookable hosts via discover_search_podcasts. x402-payable; no PAT required.

{
  "type": "object",
  "properties": {
    "host_handle": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "The PitchIQ host's PUBLIC booking handle (e.g. from discover_search_podcasts). Books on THEIR public calendar, not yours."
    },
    "start_at": {
      "type": "string",
      "format": "date-time",
      "description": "Slot start (ISO-8601 UTC). Must be a currently-free slot on the host's calendar — re-checked before insert."
    },
    "duration_minutes": {
      "type": "integer",
      "minimum": 5,
      "maximum": 240,
      "default": 30,
      "description": "Meeting length. Default 30."
    },
    "attendee_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Name of the guest being booked (the agent's principal)."
    },
    "attendee_email": {
      "type": "string",
      "format": "email",
      "description": "Guest email — receives the confirmation + cancel link."
    },
    "attendee_notes": {
      "type": "string",
      "maxLength": 2000,
      "description": "Pitch / context the host sees alongside the booking."
    }
  },
  "required": [
    "host_handle",
    "start_at",
    "attendee_name",
    "attendee_email"
  ]
}

Get a firm x402 price + payment requirements for any Commerce tool BEFORE committing — so an agent (or its spend policy) can budget. Returns the USD price, pricing class, network, and the x402 'accepts' block to construct the payment. x402-payable (read class).

{
  "type": "object",
  "properties": {
    "tool_name": {
      "type": "string",
      "description": "The Commerce tool to price (e.g. pitchiq_v1_booking_book_guest_slot). Call tools/list to see what's available."
    }
  },
  "required": [
    "tool_name"
  ]
}

Semantic search across the active workspace's wiki (the 'brain'). Finds pages by MEANING — it matches even when you use different words than the page does. Returns ranked pages (title, slug, summary). Prefer this over pitchiq_v1_wiki_search_pages when you don't know the exact wording. Requires an active workspace.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Natural-language query. Matches by meaning, not exact keywords."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "required": [
    "query"
  ]
}

Return the workspace 'brain index' — every wiki page's title, slug, and one-line summary, in hierarchy order. Call this at the START of a session to learn what the workspace already knows before searching, asking the user, or creating anything. Requires an active workspace.

{
  "type": "object",
  "properties": {}
}

Traverse the workspace knowledge graph from a specific entity. For wiki_page: returns forward links, backlinks, 5 most similar pages, and CRM entity mentions found in the page text. For contact: returns linked deals, opportunities, tasks, outreach summary, conversation count, and wiki pages mentioning this contact. For deal: returns primary contact, tasks, bookings, conversation count, and wiki pages mentioning this deal. Use this to understand relationships and discover connected information across the workspace. Requires an active workspace.

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "wiki_page",
        "contact",
        "deal"
      ],
      "description": "The type of entity to traverse from."
    },
    "entity_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of the entity to query."
    }
  },
  "required": [
    "entity_type",
    "entity_id"
  ]
}