plugin.json

{
  "name": "particle-pro-submission",
  "version": "0.1.2",
  "description": "Research companies, people, podcasts, topics, sponsorships, and alerts with Particle's OAuth-secured MCP server.",
  "author": {
    "name": "Mina Labs, Inc.",
    "email": "api@particle.pro",
    "url": "https://particle.pro"
  },
  "homepage": "https://docs.particle.pro/mcp/overview",
  "license": "UNLICENSED",
  "keywords": [
    "particle",
    "podcasts",
    "companies",
    "research",
    "mcp"
  ],
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Research a podcast and display an evidence-backed Radar card.",
              "prompt": "Use Particle Pro to find the Acquired podcast. Give me a short overview, its format, and its three most recent episodes with publication dates. Show the podcast as a Radar card using a source link returned by Particle. Do not guess if the show is ambiguous.",
              "expected_behavior": "Acceptance criteria only; no observed result. Resolve the intended podcast and request supported profile expansions. Obtain three latest episodes with publication dates from the resolver's supported recent_episodes expansion when it supplies the requested evidence; otherwise use the returned canonical podcast slug with particle_podcast_list_episodes. Summarize only returned facts and preserve episode dates. Render a podcast Radar card directly with an eligible HTTPS source URL returned by Particle. Verify the visible card, source link, and Markdown fallback agree with the retrieved evidence. Identify missing optional fields without inventing them. If no eligible source URL exists, explain the card limitation. Do not create subscriptions, alerts, or account records.",
              "tools_triggered": "particle_podcast_resolve, particle_radar_render_cards; particle_podcast_list_episodes if the resolver's recent_episodes expansion does not supply the requested latest dated episodes"
            },
            {
              "description": "Find bounded transcript evidence about a topic without downloading full transcripts.",
              "prompt": "Use Particle Pro to find three podcast passages discussing how AI affects jobs. Include a short excerpt from each, the show and episode title, publication date, and timestamp when available. Explain what each passage says, and keep direct quotes separate from your summary. Do not fetch full transcripts.",
              "expected_behavior": "Acceptance criteria only; no observed result. Searches by semantic meaning with a short topical query and a limit of three, using bounded transcript context rather than whole transcripts. Presents up to three matching passages with returned attribution, dates, and available timestamps or source links. Quotes match the returned excerpts; summaries do not invent speaker identities or claims. Does not impose an unrequested date or person filter. If the corpus has no matches, states that clearly rather than fabricating evidence.",
              "tools_triggered": "particle_podcast_search_transcripts"
            },
            {
              "description": "Research a company and distinguish detected podcast advertising from organic mentions.",
              "prompt": "Use Particle Pro to research Shopify, identified by shopify.com. Summarize its company profile and detected podcast advertising, including the shows carrying its ads and a few recent ad-read examples when available. Distinguish paid ads from ordinary mentions. Show an evidence-backed company Radar card with a source link returned by Particle.",
              "expected_behavior": "Acceptance criteria only; no observed result. Resolves shopify.com, retrieves the company profile with external_links, and requests advertising data with podcasts and segments. Reports detected advertising counts, show names, and available ad-read evidence without treating organic mentions as paid placements or claiming complete market coverage. Preserves the time windows and sponsor-alias scope supplied by the tools; unavailable data is not treated as a measured zero. Calls the card tool directly using only retrieved company facts and an eligible returned source URL. If no advertising is recorded, states the limitation without inventing placements. Does not purchase ads, contact publishers, or modify records.",
              "tools_triggered": "particle_company_resolve, particle_company_get, particle_company_get_podcast_ad_presence, particle_radar_render_cards"
            },
            {
              "description": "Resolve a public person and present professional information and podcast appearances.",
              "prompt": "Use Particle Pro to research Jensen Huang of NVIDIA. Confirm you found the right person, summarize his professional role, and list up to three recent podcast appearances with dates when available. Show a person Radar card using a source URL returned by Particle. Keep this to public professional information.",
              "expected_behavior": "Acceptance criteria only; no observed result. Resolves the person by name and checks the returned professional context before selecting a candidate; asks for clarification if the match remains ambiguous. Retrieve the profile with external_links and podcast_appearances. Request companies when the returned profile does not already corroborate the NVIDIA association or additional company detail is needed for the user's request. Summarizes returned professional information and up to three recorded appearances, preserving dates and distinguishing appearances from mere mentions. Does not invent missing appearances or infer private beliefs or sensitive traits. Calls the card tool directly with retrieved facts and an eligible returned source URL; otherwise explains the source limitation. Card content matches the text fallback.",
              "tools_triggered": "particle_person_resolve, particle_person_get, particle_radar_render_cards"
            },
            {
              "description": "Preview historical mentions and inspect existing review-project alerts without changing them.",
              "prompt": "In my connected Particle Pro review project, resolve NVIDIA and preview entity mentions over the past seven days. Then list up to five existing alerts; if any are present, show the first returned alert configuration and up to five recent matches using its exact returned ID. Do not create, edit, activate, pause, delete, or deliver alerts, and do not change my plan or switch endpoints.",
              "tools_triggered": "particle_company_resolve or particle_entity_resolve (confirmed company result), particle_alert_preview, particle_alert_list; particle_alert_get and particle_alert_list_matches only if the returned existing-alert list is nonempty",
              "expected_behavior": "Acceptance criteria only; no observed result. Resolve NVIDIA with particle_company_resolve or a particle_entity_resolve result explicitly typed as a company whose returned identity corroborates NVIDIA. Use its returned canonical slug for a seven-day ENTITY_MENTION historical preview. Clearly distinguish an in-progress preview from a completed count; do not claim pending results are zero. Preview may cache historical results but must not create alerts or send notifications. List only existing alerts in the authenticated review project. If the list is empty, report that and stop the alert inspection. Otherwise fetch the selected returned ID and bounded match history, preserving dates and source evidence. Do not modify alerts, subscriptions, billing settings, recipients, or another project. Explain stable access or entitlement errors honestly without proposing purchases or switching connections."
            }
          ],
          "negative": [
            {
              "description": "Do not confuse podcast research with podcast production or publishing.",
              "prompt": "Record a new podcast episode with my microphone, edit out the pauses, and upload it to Spotify for Creators.",
              "expected_behavior": "Acceptance criteria only; no observed result. Does not invoke Particle Pro tools. Explains that this app researches existing podcast content and cannot record audio, edit media, or publish episodes. It may offer general guidance or suggest an appropriate production tool without claiming anything was recorded or uploaded."
            },
            {
              "description": "Do not confuse company research with stock trading.",
              "prompt": "Buy 100 shares of NVIDIA in my brokerage account right now. I am asking for a trade, not company research.",
              "expected_behavior": "Acceptance criteria only; no observed result. Does not invoke Particle Pro tools. Explains that the app cannot access a brokerage account or execute stock trades, and does not claim to have placed an order or ask for brokerage credentials."
            },
            {
              "description": "Do not confuse alert delivery with bulk marketing email.",
              "prompt": "Send a promotional email for my product to every podcast host in Particle Pro. Do not create a monitoring alert; I want a bulk email campaign.",
              "expected_behavior": "Acceptance criteria only; no observed result. Does not invoke Particle Pro tools, collect recipient addresses, or create alerts as a workaround. Explains that the app does not provide bulk marketing outreach and cannot send this campaign. Does not claim emails were sent."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin does not sell products, process payments, start subscriptions, or change billing. It accesses existing eligible Particle accounts; ordinary metered research usage and previously enabled overage can still apply.",
        "demo_recording_url": "https://drive.google.com/file/d/1vQZ-nBRBg-YGMLcNYSscZ96lOcucYi87/view?usp=drivesdk"
      },
      "publication": {
        "release_notes": "Version 0.1.2 updates the Particle Pro listing and icons, adds request-sized bounded transcript search guidance, improves Markdown handling of titles containing pipes, clarifies advertising sponsor-alias and coverage-window limits, and aligns the review cases with supported equivalent tool paths. The plugin uses the fixed 36-tool Particle MCP connection at https://mcp.particle.pro/plugins. Alert monitoring guidance covers historical previews and existing alerts; alert creation and updates are unavailable."
      },
      "interface": {
        "displayName": "Particle Pro",
        "shortDescription": "Podcast & company intelligence",
        "longDescription": "Research companies, people, podcasts, topics, rankings, sponsorships, and alerts through Particle's connected data graph.",
        "developerName": "Mina Labs, Inc.",
        "category": "Data & Analytics",
        "capabilities": [
          "Search",
          "Research",
          "Write"
        ],
        "websiteURL": "https://particle.pro",
        "privacyPolicyURL": "https://particle.pro/legal/privacy-services",
        "termsOfServiceURL": "https://particle.pro/legal/tos-api",
        "defaultPrompt": [
          "Find what podcast hosts have said about AI agents recently.",
          "Build a company brief with leaders, competitors, and podcast mentions.",
          "Show trending podcast guests in artificial intelligence."
        ],
        "brandColor": "#2B4CF0",
        "composerIcon": "./assets/particle-mark.svg",
        "logo": "./assets/particle-mark.svg",
        "logoDark": "./assets/particle-mark-dark.svg",
        "supportURL": "https://platform.particle.pro/support",
        "composerIconDark": "./assets/particle-mark-dark.svg"
      },
      "apps": "./.app.json"
    }
  },
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json"
}