Skip to main content
The Particle Pro MCP server exposes 32 tools across 13 exposure categories. Each tool wraps an existing REST handler — the per-tool pages link to the analogous REST endpoint when one exists. Tools belong to default categories (advertised on a bare connection) or opt-in categories (advertised only when selected via the ?include= selector). Either way, every public tool is callable by name regardless of what was advertised — see Tool sets & discovery for the selector mechanics and the always-callable contract. Most tools advertise readOnlyHint: true. The exception is the alerts category: particle_alert_create and particle_alert_update mutate your project’s alerts, and particle_alert_delete is a destructive soft delete — these act on the single project your credential is scoped to. Inputs use snake_case JSON; outputs are a single markdown text block (content[].text), and passing output_format: "json" swaps that block for the compact JSON form of the same response. Tool names are flat particle_* identifiers. Read this list through two conventions (the server states both in its initialize instructions): tools are lean by defaultinclude arrays and mode/format switches expand them well beyond their one-line summaries — and slugs are edges: any slug one tool returns is a valid input to the others, so resolve a name once, then traverse the graph (company → its people → a person’s appearances → that episode’s transcript and entities). See How the tools compose.

System

Always-on discovery meta-tools — the surface is self-expanding from a bare connection.

particle_catalog

Browse the full tool catalog; with a category, full input schemas.

particle_call

Dispatch any public tool by name (fallback for un-advertised tools).

Podcasts

Resolve podcasts, list and fetch episodes, search transcripts, and find entity mentions.

particle_podcast_resolve

Find a podcast by title, slug, iTunes ID, or RSS URL; optional hydrations.

particle_podcast_get_episode

Bundled episode overview — speakers, entities, segments, clips, topics, transcript.

particle_podcast_find_mentions

Every dialogue line where a person or company is named.

particle_podcast_search_transcripts

Semantic, keyword, or hybrid search over dialogue, segments, and clips.

particle_podcast_list_episodes

Filter-driven episode discovery across the catalog.

particle_podcast_get_episode_timeseries

Time-bucketed episode and mention counts — trend lines per day, week, or month.

particle_podcast_list_clips

Highlight clips ranked by engagement, with per-clip detail and transcript.

People

Resolve people and entities to canonical handles and fetch person profiles.

particle_entity_get

One knowledge-graph entity’s profile — confirm what a slug refers to.

particle_entity_resolve

Union resolver — person, company, place, or other, with a typed handle.

particle_person_resolve

People-only resolver — canonical person slug.

particle_person_get

Person profile — role, bio, external links, appearances, role history.

Companies

Resolve companies and fetch company profiles with people, products, and competitors.

particle_company_resolve

Resolve a company by name, ticker, domain, CIK, or QID.

particle_company_get

Bundled company profile — identifiers, people, products, competitors.

Alerts

Create and manage alerts that watch entities for podcast mentions or speaker appearances, preview match frequency, and review what an alert has caught. The only writable, project-scoped category — these act on the single project your credential is bound to.

particle_alert_create

Create an alert watching entity slugs for mentions or speaker appearances.

particle_alert_list

List your project’s alerts, newest first, with their ids.

particle_alert_get

One alert’s full config; optional embedded matches and deliveries.

particle_alert_update

Retitle, change cadence, pause/resume, or replace the watch list.

particle_alert_delete

Soft-delete an alert; past matches and deliveries are retained.

particle_alert_preview

Preview how often an alert would fire before creating it.

particle_alert_list_matches

What an alert caught — episode edges, optional transcript windows.

Topics

Browse the hierarchical topic taxonomy used to classify podcast episodes.

particle_topic_browse

Navigate the topic taxonomy — roots and direct children.

Podcast rankings

Podcast chart rankings: current charts, movers, and ranking history.

particle_podcast_get_rankings

Apple/Spotify charts in three modes — chart, movers, history.

Podcast guests

Podcast guest directory, trending guests, and per-guest appearance profiles.

particle_podcast_list_guests

Guest directory (lifetime) or trending guests (last 30 days).

particle_podcast_get_guest

A guest’s appearance profile, per-podcast rollup, suitability exposure.

Podcast advertising

Sponsor analytics — per-company, per-podcast, and across the catalog. Add ?include=podcast_advertising to advertise these on tools/list.

particle_company_get_podcast_ad_presence

Where company X shows up as a sponsor.

particle_podcast_get_sponsors

Who sponsors podcast Y, plus aggregate stats.

particle_podcast_get_sponsor_leaderboard

Top advertisers across the catalog — and the publishers carrying the most ads.

particle_podcast_get_episode_ads

Every detected ad read inside one episode, with exact offsets.

particle_podcast_get_ad_trends

Sponsors ramping up or pulling back, and one company’s ad volume over time.

Podcast publishers

Publisher profiles with their shows, bias profile, and suitability profile. Add ?include=podcast_publishers.

particle_podcast_get_publisher

A publisher’s profile — shows, bias profile, suitability profile.

Podcast ratings

Listener review ratings for podcasts. Add ?include=podcast_ratings.

particle_podcast_get_ratings

Aggregate summary, per-platform breakdown, sentiment, recent reviews.

Podcast bias

Corpus-wide political-bias views. Add ?include=podcast_bias.

particle_podcast_get_bias_leaderboard

Rank publishers by political-bias metrics.

particle_podcast_list_bias_publishers

Which publishers have the most podcasts in one bias bucket.

Podcast suitability

Corpus-wide GARM brand-suitability views. Add ?include=podcast_suitability.

particle_podcast_get_suitability_leaderboard

Rank publishers by IAB/GARM brand-suitability composition.

particle_podcast_list_suitability_category_publishers

Publishers most (or least) exposed to one GARM category.

Tiers

Every tool carries a billing tier, surfaced in particle_catalog: Premium tools require a plan that includes premium endpoints; on plans without them the call returns an isError result with code premium_required and upgrade guidance. See Errors for how billing failures surface.

Safety

Almost every tool is read-only (readOnlyHint: true) — no read tool mutates your Particle Pro data, spends money beyond metered usage, or acts on external systems. The exception is the alerts category: particle_alert_create and particle_alert_update write alerts, and particle_alert_delete is a destructive soft delete — all confined to the single project your credential is scoped to, with no way to reach another project’s alerts. Tool outputs also contain third-party content (transcripts, reviews, show notes), so when you combine this server with other MCP servers that can take actions, keep your client’s human confirmation enabled for those action tools to avoid prompt-injection chains from untrusted content.
Missing a tool you need? Email api@particle.pro — the surface grows in the direction people pull it.

Choosing the right tool