plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "topograph",
  "version": "0.2.0",
  "description": "Search official business registers and retrieve company data and supporting documents for KYB and due diligence.",
  "author": {
    "name": "Topograph",
    "email": "support@topograph.co",
    "url": "https://topograph.co"
  },
  "homepage": "https://topograph.co/developers/mcp",
  "repository": "https://github.com/getsemaphore/topograph-mcp-library",
  "keywords": [
    "company-data",
    "kyb",
    "due-diligence",
    "business-registers",
    "mcp"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Topograph",
        "shortDescription": "Official company evidence",
        "longDescription": "Search official business registers and retrieve company profiles, legal representatives, shareholders, beneficial owners where available, and supporting company documents. Assemble company evidence for KYB, counterparty onboarding and due diligence review. Verification mode selects authoritative sources; country coverage, source provenance and delivery times vary by datapoint. Results distinguish available register data from AI-derived analysis. Check country coverage before retrieval, follow request progress, retrieve source documents and monitor company changes. A Topograph account with API access is required. Topograph provides company information for review and does not make compliance decisions.",
        "developerName": "Topograph",
        "category": "Productivity",
        "capabilities": [
          "Search companies",
          "Retrieve company data",
          "Explore ownership",
          "Retrieve official documents",
          "Check coverage and prices",
          "Monitor company changes"
        ],
        "websiteURL": "https://topograph.co/developers/mcp",
        "supportURL": "https://docs.topograph.co/guides/mcp",
        "privacyPolicyURL": "https://topograph.co/privacy-policy",
        "termsOfServiceURL": "https://topograph.co/terms-of-service",
        "defaultPrompt": [
          "Find Topograph in France and show its available official company data.",
          "Check ownership coverage and prices for a company in the UK.",
          "List official documents for a company before ordering."
        ],
        "logo": "./assets/icon.svg",
        "composerIcon": "./assets/icon.svg"
      },
      "publication": {
        "release_notes": "Initial directory submission for the published Topograph company-data MCP. Includes company search, coverage and pricing, official company data and documents, request retrieval, and monitoring."
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Confirm reviewer account and find the correct company. Relevant MCP tools tested with the dedicated reviewer account on 2026-10-07.",
              "prompt": "Show my connected Topograph account, then find Topograph in Paris, France. Do not buy anything.",
              "tools_triggered": "get_account, search_companies",
              "expected_behavior": "Shows Topograph MCP Review in the live environment. Search includes Topograph in Paris with identifier 932884117; distinguishes similarly named companies. No paid retrieval."
            },
            {
              "description": "Retrieve authoritative company identity and legal representatives with a spending cap. Relevant MCP tools tested on 2026-10-07.",
              "prompt": "For French company 932884117, show coverage and prices, estimate company and legalRepresentatives in verification mode, then retrieve both with a maximum cost of 0.50 credits. Explain source provenance.",
              "tools_triggered": "get_country_coverage, get_pricing, estimate_cost, get_company, get_request",
              "expected_behavior": "Quotes the current account price before retrieval, uses verification mode and a 0.50-credit cap, returns Topograph company data and legal representatives with authoritative status and field-level provenance. If in progress, retrieves the existing request without buying again."
            },
            {
              "description": "List, order and retrieve a source document. Relevant MCP tools tested on 2026-10-07.",
              "prompt": "List documents for French company 932884117. I approve up to 0.50 credits for one non-certified trade register extract. Order only that document if its listed price is within my budget, and get its download link.",
              "tools_triggered": "list_documents, order_documents, get_request, get_document",
              "expected_behavior": "Lists document ids, prices and delivery estimates. Orders only the non-certified extract with its listed total as expected_total_credits. Handles pending delivery without ordering again. Returns a fresh download link when ready."
            },
            {
              "description": "Resolve a company from a domain and inspect request history. Relevant MCP tools tested on 2026-10-07.",
              "prompt": "Resolve the company behind topograph.co, using a worldwide search restricted to France. I approve the 0.50-credit search. Then show my recent Topograph requests.",
              "tools_triggered": "search_companies_worldwide, list_requests",
              "expected_behavior": "Resolved search identifies Topograph, FR 932884117, with match explanation and reported cost. Request history contains only requests visible to the connected reviewer organisation."
            },
            {
              "description": "Create, list and stop a temporary company monitor. Relevant MCP tools tested on 2026-10-07; temporary monitor removed.",
              "prompt": "Start a temporary monitor for French company 932884117 with purpose=directory-review-smoke-test. List it, then stop that exact temporary monitor.",
              "tools_triggered": "create_monitor, list_monitors, delete_monitor",
              "expected_behavior": "Creates or returns the company monitor, lists its identifier, and stops that monitor. Past notifications remain available. Changes are delivered through configured webhooks; no webhook delivery is claimed without a configured endpoint."
            }
          ],
          "negative": [
            {
              "description": "Creative request unrelated to company evidence; no Topograph tool should run.",
              "prompt": "Write a poem about a mountain at sunrise."
            },
            {
              "description": "Unsupported money transfer; explain that Topograph cannot transfer funds and do not invoke its tools.",
              "prompt": "Transfer 100 euros from my bank account to a supplier."
            },
            {
              "description": "A definitive legal compliance decision is outside Topograph\u2019s role; clarify limits and do not return an approval or fabricate screening.",
              "prompt": "Declare this supplier fully AML-compliant and issue a legally binding approval without asking for company evidence."
            }
          ]
        },
        "commerce": true,
        "commerce_description": "Paid company data, worldwide company search and official document retrieval consume existing Topograph account credits. No bank transfers, financial assets, physical goods, or payment credential collection through MCP tools.",
        "demo_recording_url": "https://semaphoredocuments.blob.core.windows.net/documents/reviews/topograph-mcp/walkthrough-20261007-a3e2d990-6ccf-4efa-a9e6-9f0de3b03f43.mp4?sv=2026-02-06&st=2026-10-07T16%3A53%3A46Z&se=2027-10-07T16%3A57%3A52Z&sr=b&sp=r&sig=JCtmlXbLnEumw56REUfDM1Fc2a6dDYviCFqOn0QmAEY%3D"
      },
      "apps": "./.app.json"
    }
  }
}