Skip to main content
The Particle Pro MCP server exposes 25 tools across 12 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. Every tool advertises readOnlyHint: true. 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.

People

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

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.

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.

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:
TierTools
FreeThe system meta-tools — particle_catalog, particle_call (the dispatched inner tool meters at its own tier). Discovery never costs anything.
StandardEverything not listed below — all resolvers, particle_person_get, particle_company_get, particle_podcast_get_episode, particle_podcast_list_episodes, particle_topic_browse, guests, publisher, and ratings tools.
Premiumparticle_podcast_search_transcripts, particle_podcast_find_mentions, particle_podcast_get_rankings, the three podcast_advertising tools, both podcast_bias tools, and both podcast_suitability tools.
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

Every tool is read-only (readOnlyHint: true) — no tool mutates your Particle Pro data, spends money beyond metered usage, or acts on external systems. Still, tool outputs 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

I want…Use this
To turn a name into a slug (any kind)particle_entity_resolve
To turn a person’s name into a slugparticle_person_resolve
To turn a ticker, domain, or CIK into a companyparticle_company_resolve
Every line where a person or company is namedparticle_podcast_find_mentions
Dialogue about a topic (paraphrase or exact), with overlapping clipsparticle_podcast_search_transcripts
Episode-level discovery with rich filtersparticle_podcast_list_episodes
A full episode overview (segments, clips, topics, transcript)particle_podcast_get_episode
A podcast’s chart movers or historyparticle_podcast_get_rankings
Who’s a frequent or trending podcast guestparticle_podcast_list_guests
”Where does company X advertise”particle_company_get_podcast_ad_presence
”Who sponsors podcast Y”particle_podcast_get_sponsors
Catalog-wide top advertisersparticle_podcast_get_sponsor_leaderboard
A publisher’s bias / suitability profileparticle_podcast_get_publisher
Which publishers lean hardest left/rightparticle_podcast_get_bias_leaderboard
The safest / riskiest publishers to advertise onparticle_podcast_get_suitability_leaderboard
To discover or call a tool you haven’t seen advertisedparticle_catalog / particle_call