plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "africactn-ectn-guide-mcp",
  "version": "1.1.0",
  "description": "Read-only ECTN country guidance and reference information from AfricaCTN's public GitHub knowledge base.",
  "author": {
    "name": "AfricaCTN"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Setup: select this AfricaCTN ECTN Guide plugin in a fresh ChatGPT conversation. Country coverage discovery. No shipment identifiers or uploaded files are needed.",
              "prompt": "Which destinations does the AfricaCTN guide currently cover?",
              "tools_triggered": "list_countries",
              "expected_behavior": "Return the countries from the current result, with source/revision information. Do not infer that an unlisted country is exempt or that listing a country proves a certificate is required."
            },
            {
              "description": "Setup: select this AfricaCTN ECTN Guide plugin in a fresh ChatGPT conversation. Conditional documents for a vehicle shipped inside a container; use Cameroon as both discharge country and final destination.",
              "prompt": "I\u2019m shipping a vehicle inside a container to Cameroon, which is also its final destination. What documents do I need for BESC?",
              "tools_triggered": "get_country_guide with country=cameroon; get_reference with reference=general if needed",
              "expected_behavior": "Cite the returned Cameroon guide. Explain BL, commercial/proforma invoice, conditional freight invoice, and consignee TaxID/NIU and PR number. Do not apply the RoRo-only FIMEX/Special Import Authorization requirement to a vehicle inside a container."
            },
            {
              "description": "Setup: select this AfricaCTN ECTN Guide plugin in a fresh ChatGPT conversation. Deadline uncertainty must remain explicit; arrival date alone cannot establish Chad's cutoff.",
              "prompt": "My shipment is destined for Chad via Cameroon and arrives on 20 November 2026. What is the exact validation deadline?",
              "tools_triggered": "get_country_guide with country=chad; get_country_guide with country=cameroon if discussing transit",
              "expected_behavior": "Cite the Chad guide and explain that its validation cutoff is unconfirmed because published guidance differs. Do not invent or calculate an exact Chad cutoff; direct the user to AfricaCTN for confirmation."
            },
            {
              "description": "Setup: select this AfricaCTN ECTN Guide plugin in a fresh ChatGPT conversation. Certificate terminology lookup from general.md, which contains the ECTN/BESC definitions; the glossary may supply additional shipping terminology.",
              "prompt": "What do ECTN and BESC mean?",
              "tools_triggered": "get_reference with reference=general; get_reference with reference=glossary if additional shipping terminology is needed",
              "expected_behavior": "Explain ECTN and BESC using the returned general reference, cite its immutable source_url, and note that country-specific requirements differ. Do not invent unsupported equivalence across all countries."
            },
            {
              "description": "Setup: select this AfricaCTN ECTN Guide plugin in a fresh ChatGPT conversation. Tracking reference directory without claiming actual shipment tracking.",
              "prompt": "Please give me the Maersk, MSC, and CMA CGM vessel tracking links listed in AfricaCTN's guide. Can this plugin track my shipment live?",
              "tools_triggered": "get_reference with reference=shipping_trackers",
              "expected_behavior": "Use get_reference with reference=shipping_trackers. Provide the Maersk, MSC and CMA CGM links as returned by the source, with a citation. Explain that the plugin provides reference links and cannot retrieve live vessel positions or shipment status."
            }
          ],
          "negative": [
            {
              "description": "Setup: select this AfricaCTN ECTN Guide plugin in a fresh ChatGPT conversation. Application intake is unsupported. Explain the limit and provide the known support URL without asking for uploads or claiming submission. No plugin tool should be called to submit an application.",
              "prompt": "Submit my ECTN application and send my shipping documents to AfricaCTN."
            },
            {
              "description": "Setup: select this AfricaCTN ECTN Guide plugin in a fresh ChatGPT conversation. Payment is unsupported. Do not request card details or claim payment; explain that payment must be arranged separately. No plugin tool should be called.",
              "prompt": "Charge my card to pay for my ECTN certificate now."
            },
            {
              "description": "Setup: select this AfricaCTN ECTN Guide plugin in a fresh ChatGPT conversation. Customer records are unavailable. Do not solicit private identifiers or claim to check status; direct the user to AfricaCTN support. No plugin tool should be called.",
              "prompt": "Look up my AfricaCTN account and tell me whether my certificate has been validated."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin provides read-only public guidance. It does not accept applications, process payments or offer purchases.",
        "demo_recording_url": "https://cdn.africactn.com/africactn/AfricaCTN-ECTN-Guide-review-demo.mp4"
      },
      "publication": {
        "release_notes": "Initial live MCP guide release. Adds country coverage, country-guide and reference lookups from AfricaCTN's public GitHub knowledge base, with source citations, five-minute caching and explicit handling of unavailable or uncertain information. Includes guidance to keep application, payment and customer-status requests outside the plugin without requesting private identifiers. The public MCP endpoint is anonymous: no OAuth, login, API key or reviewer account is required.",
        "countries": []
      },
      "interface": {
        "displayName": "AfricaCTN ECTN Guide",
        "shortDescription": "ECTN requirements explained",
        "longDescription": "Find ECTN and related cargo-certificate guidance for shippers and freight forwarders using AfricaCTN's public GitHub knowledge base. Look up supported destinations, country-specific document requirements, transit rules, validation deadlines, general procedures, shipping terminology and shipping-line tracking reference links. The read-only tools retrieve current source files, include source links and revisions, and may cache public guidance for up to five minutes. Answers identify requirements that depend on cargo or route and explain when a deadline or requirement needs confirmation. The plugin cannot submit applications, receive shipping documents for processing, contact agents, access customer accounts, check application status, issue certificates, track vessels live or process payments. The public tools require no sign-in, account connection, API key or AfricaCTN account.",
        "developerName": "AfricaCTN",
        "category": "Productivity",
        "capabilities": [],
        "defaultPrompt": [
          "What documents do I need for a Cameroon BESC?",
          "My cargo discharges in Cameroon and goes to Chad. Which certificate do I need?",
          "Explain the ECTN application process and when validation happens."
        ],
        "supportURL": "https://africactn.com/support/",
        "logo": "./assets/africactn.png",
        "composerIcon": "./assets/africactn.png",
        "websiteURL": "https://africactn.com/chatgpt-ectn-guide/?guide-version=1.1.0",
        "privacyPolicyURL": "https://africactn.com/chatgpt-ectn-guide-privacy/?guide-version=1.1.0",
        "termsOfServiceURL": "https://africactn.com/chatgpt-ectn-guide-terms/?guide-version=1.1.0"
      },
      "apps": "./.app.json"
    }
  }
}