Global Database Agent

{
  "name": "Global Database Agent",
  "description": "Resolves, verifies, and enriches company and people data from Global Database — KYB/compliance checks, financials, digital footprint, decision-maker discovery, prospecting, and composed sales/risk flows.",
  "supportedInterfaces": [
    {
      "url": "https://a2a.globaldatabase.com",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "url": "https://globaldatabase.com",
    "organization": "Global Database"
  },
  "version": "0.1.0",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "extensions": [
      {
        "uri": "https://a2ui.org/a2a-extension/a2ui/v0.9",
        "description": "Render a skill reply as an A2UI Card, for clients that support it.",
        "params": {
          "supportedCatalogIds": [
            "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json"
          ],
          "acceptsInlineCatalogs": false
        }
      }
    ]
  },
  "securitySchemes": {
    "gdbOAuth": {
      "oauth2SecurityScheme": {
        "description": "Sign in with your Global Database account via OAuth 2.1 (Authorization Code + PKCE). No API key to copy or paste -- the access token is issued directly to the connection.",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://mcp.globaldatabase.com/authorize",
            "tokenUrl": "https://mcp.globaldatabase.com/token",
            "pkceRequired": true
          }
        },
        "oauth2MetadataUrl": "https://mcp.globaldatabase.com/.well-known/oauth-authorization-server"
      }
    }
  },
  "securityRequirements": [
    {
      "schemes": {
        "gdbOAuth": {}
      }
    }
  ],
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "resolve_company",
      "name": "Resolve company",
      "description": "Finds/confirms a company by any identifier: company_id, name (with country_code), registration_number, vat_number, ticker, website, linkedin or email.",
      "tags": [
        "company",
        "lookup"
      ],
      "examples": [
        "{\"skill\": \"resolve_company\", \"input\": {\"name\": \"Global Database\", \"country_code\": \"GB\"}}",
        "{\"skill\": \"resolve_company\", \"input\": {\"company_id\": \"12345\"}}",
        "{\"skill\": \"resolve_company\", \"input\": {\"registration_number\": \"09410808\", \"country_code\": \"GB\"}}",
        "{\"skill\": \"resolve_company\", \"input\": {\"vat_number\": \"GB260423730\"}}",
        "{\"skill\": \"resolve_company\", \"input\": {\"website\": \"globaldatabase.com\"}}"
      ]
    },
    {
      "id": "verify_company",
      "name": "Verify company (KYB)",
      "description": "Full compliance dossier: registry profile, officers, shareholders/UBO, and group structure, in parallel. Identify the company by any of: company_id, name (with country_code), registration_number, vat_number, ticker, website, email or linkedin.",
      "tags": [
        "kyb",
        "compliance"
      ],
      "examples": [
        "{\"skill\": \"verify_company\", \"input\": {\"company_id\": \"12345\"}}",
        "{\"skill\": \"verify_company\", \"input\": {\"name\": \"Tesco PLC\", \"country_code\": \"GB\"}}",
        "{\"skill\": \"verify_company\", \"input\": {\"registration_number\": \"00445790\", \"country_code\": \"GB\"}}",
        "{\"skill\": \"verify_company\", \"input\": {\"vat_number\": \"GB220430231\"}}",
        "{\"skill\": \"verify_company\", \"input\": {\"website\": \"tesco.com\"}}"
      ]
    },
    {
      "id": "financial_snapshot",
      "name": "Financial snapshot",
      "description": "Financial health from two sources: commercial ratios/YoY and officially filed statements, in parallel. Identify the company by any of: company_id, name (with country_code), registration_number, vat_number, ticker, website, email or linkedin.",
      "tags": [
        "financials",
        "compliance"
      ],
      "examples": [
        "{\"skill\": \"financial_snapshot\", \"input\": {\"company_id\": \"12345\"}}",
        "{\"skill\": \"financial_snapshot\", \"input\": {\"name\": \"Tesco PLC\", \"country_code\": \"GB\"}}",
        "{\"skill\": \"financial_snapshot\", \"input\": {\"registration_number\": \"00445790\", \"country_code\": \"GB\"}}",
        "{\"skill\": \"financial_snapshot\", \"input\": {\"vat_number\": \"GB220430231\"}}",
        "{\"skill\": \"financial_snapshot\", \"input\": {\"website\": \"tesco.com\"}}"
      ]
    },
    {
      "id": "company_intelligence",
      "name": "Company intelligence",
      "description": "Company profile plus digital footprint (tech stack, traffic, SEO, WHOIS). Identify the company by any of: company_id, name (with country_code), registration_number, vat_number, ticker, website, email or linkedin.",
      "tags": [
        "intelligence",
        "sales"
      ],
      "examples": [
        "{\"skill\": \"company_intelligence\", \"input\": {\"company_id\": \"12345\"}}",
        "{\"skill\": \"company_intelligence\", \"input\": {\"name\": \"Tesco PLC\", \"country_code\": \"GB\"}}",
        "{\"skill\": \"company_intelligence\", \"input\": {\"registration_number\": \"00445790\", \"country_code\": \"GB\"}}",
        "{\"skill\": \"company_intelligence\", \"input\": {\"vat_number\": \"GB220430231\"}}",
        "{\"skill\": \"company_intelligence\", \"input\": {\"website\": \"tesco.com\"}}"
      ]
    },
    {
      "id": "find_decision_makers",
      "name": "Find decision makers",
      "description": "Finds people at a company by web domain, or by company + role/department/seniority filters.",
      "tags": [
        "people",
        "sales"
      ],
      "examples": [
        "{\"skill\": \"find_decision_makers\", \"input\": {\"domain\": \"acme.com\", \"employee_seniorities\": [\"c_suite\"]}}"
      ]
    },
    {
      "id": "get_person_contact",
      "name": "Get person contact",
      "description": "Email and phone for a person: by email or LinkedIn URL if already known, or by first name + last name + their company name or domain.",
      "tags": [
        "contacts",
        "enrichment"
      ],
      "examples": [
        "{\"skill\": \"get_person_contact\", \"input\": {\"email\": \"jane@example.com\"}}",
        "{\"skill\": \"get_person_contact\", \"input\": {\"first_name\": \"Jane\", \"last_name\": \"Doe\", \"domain\": \"acme.com\"}}"
      ]
    },
    {
      "id": "get_person_details",
      "name": "Get person details",
      "description": "Full profile for one person by employee_id -- the 'id' from a find_decision_makers row. Different from get_person_contact: no email/phone here, but job title, department, seniority, nationality, and social profiles.",
      "tags": [
        "people",
        "sales"
      ],
      "examples": [
        "{\"skill\": \"get_person_details\", \"input\": {\"employee_id\": \"123456\"}}"
      ]
    },
    {
      "id": "find_companies",
      "name": "Find companies",
      "description": "Finds companies matching criteria — leads/prospecting. Filters: name, location_countries, industry_keyword, employees_gte, employees_lte, turnover_gte, turnover_lte, financial_turnover_currency, page, per_page. Ranges are named after the boundary they set, so \"more than 50 employees\" is employees_gte: 50.",
      "tags": [
        "prospecting",
        "sales"
      ],
      "examples": [
        "{\"skill\": \"find_companies\", \"input\": {\"location_countries\": [\"GB\"], \"industry_keyword\": \"software\"}}",
        "{\"skill\": \"find_companies\", \"input\": {\"location_countries\": [\"RO\"], \"employees_gte\": 50, \"per_page\": 20}}",
        "{\"skill\": \"find_companies\", \"input\": {\"name\": \"Tesco\", \"turnover_gte\": 1000000, \"turnover_lte\": 50000000, \"financial_turnover_currency\": \"GBP\", \"employees_lte\": 500}}"
      ]
    },
    {
      "id": "person_corporate_footprint",
      "name": "Person corporate footprint",
      "description": "All directorships and shareholdings on file for a named person, across companies (AML/PEP-style background check).",
      "tags": [
        "kyb",
        "compliance"
      ],
      "examples": [
        "{\"skill\": \"person_corporate_footprint\", \"input\": {\"name\": \"Jane Doe\"}}",
        "{\"skill\": \"person_corporate_footprint\", \"input\": {\"name\": \"Jane Doe\", \"company_name\": \"Acme Inc\"}}"
      ]
    },
    {
      "id": "find_and_contact_leads",
      "name": "Find and contact leads",
      "description": "Sales prospecting flow: finds target companies, the decision maker at each, and their contact details, in one call.",
      "tags": [
        "sales",
        "flow"
      ],
      "examples": [
        "{\"skill\": \"find_and_contact_leads\", \"input\": {\"location_countries\": [\"GB\"], \"job_title\": [\"CFO\"], \"max_results\": 5}}"
      ]
    },
    {
      "id": "vendor_onboarding_check",
      "name": "Vendor onboarding check",
      "description": "Procurement/risk flow: KYB verification, financial snapshot, and company intelligence, in parallel. Identify the company by any of: company_id, name (with country_code), registration_number, vat_number, ticker, website, email or linkedin.",
      "tags": [
        "risk",
        "flow"
      ],
      "examples": [
        "{\"skill\": \"vendor_onboarding_check\", \"input\": {\"company_id\": \"12345\"}}",
        "{\"skill\": \"vendor_onboarding_check\", \"input\": {\"name\": \"Tesco PLC\", \"country_code\": \"GB\"}}",
        "{\"skill\": \"vendor_onboarding_check\", \"input\": {\"registration_number\": \"00445790\", \"country_code\": \"GB\"}}",
        "{\"skill\": \"vendor_onboarding_check\", \"input\": {\"vat_number\": \"GB220430231\"}}",
        "{\"skill\": \"vendor_onboarding_check\", \"input\": {\"website\": \"tesco.com\"}}"
      ]
    },
    {
      "id": "compare_companies",
      "name": "Compare companies",
      "description": "Side-by-side KYB + financial comparison of 2-5 companies — procurement/investment decision support.",
      "tags": [
        "risk",
        "flow"
      ],
      "examples": [
        "{\"skill\": \"compare_companies\", \"input\": {\"companies\": [{\"company_id\": \"1\"}, {\"company_id\": \"2\"}]}}",
        "{\"skill\": \"compare_companies\", \"input\": {\"companies\": [{\"website\": \"acme.com\"}, {\"website\": \"beta.com\"}]}}"
      ]
    },
    {
      "id": "whoami",
      "name": "Who am I",
      "description": "Verifies the caller's own access token and returns their Global Database account identity -- name, email, active status.",
      "tags": [
        "account"
      ],
      "examples": [
        "{\"skill\": \"whoami\", \"input\": {}}"
      ]
    }
  ]
}