MetaMap API — GovChecks

naftiko: 1.0.0-alpha2
info:
  label: MetaMap API — GovChecks
  description: 'MetaMap API — GovChecks. 40+ government-database checks across Latin America, Africa, and Asia.
    Self-contained Naftiko capability exposing the GovCheck business surface, with one operation per
    country/dataset pair (Brazil CPF, CPF-light, CNPJ; Chile Registro Civil; Colombia Migration, Govcheck,
    Unified Legal, RUES, PPT; Costa Rica TSE; Dominican RNC; Ghana Verify Card and Facematch; Kenya BRS, IPRS;
    Mexico RFC, RFC Status, PEP, CURP, INE; Nigeria NIN, VIN, DL, CAC, TIN, CAC Affiliates; Panama TSE and
    Facematch; Paraguay RCP; Peru Govcheck, Migration, SUNAT; Philippines UMID/SSN; Uruguay Registro Civil).'
  tags:
  - MetaMap
  - GovCheck
  - KYC
  - Government Database
  - Latin America
  - Africa
  - Identity Verification
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    METAMAP_ACCESS_TOKEN: METAMAP_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: metamap-govchecks
    baseUri: https://api.prod.metamap.com
    description: MetaMap GovChecks business capability. All GovCheck operations share the same auth and base URI.
    resources:
    - name: govchecks
      path: /govchecks/v1
      operations:
      - {name: brcnpjextended, method: POST, path: /govchecks/v1/br/cnpj-extended, description: 'Brazil: validate CNPJ (business tax registry, extended).'}
      - {name: brcpfvalidation, method: POST, path: /govchecks/v1/br/cpf-validation, description: 'Brazil: validate CPF and identity.'}
      - {name: brcpflight, method: POST, path: /govchecks/v1/br/cpf-light, description: 'Brazil: validate CPF (light).'}
      - {name: clregistrocivil, method: POST, path: /govchecks/v1/cl/registro-civil, description: 'Chile: validate RUN against Civil Registry.'}
      - {name: cogovcheck, method: POST, path: /govchecks/v1/co/govcheck, description: 'Colombia: validate national ID against Civil Registry.'}
      - {name: comigraciones, method: POST, path: /govchecks/v1/co/migraciones, description: 'Colombia: check immigration status.'}
      - {name: counifiedcriminal, method: POST, path: /govchecks/v1/co/unified-criminal-search, description: 'Colombia: unified police-records check.'}
      - {name: corues, method: POST, path: /govchecks/v1/co/rues, description: 'Colombia: business RUES (tax & social registry).'}
      - {name: coppt, method: POST, path: /govchecks/v1/co/ppt, description: 'Colombia: validate PPT (Permiso por Protección Temporal).'}
      - {name: crtse, method: POST, path: /govchecks/v1/cr/tse, description: 'Costa Rica: validate DNI against TSE.'}
      - {name: dornc, method: POST, path: /govchecks/v1/do/rnc, description: 'Dominican Republic: validate RNC.'}
      - {name: ghverifycard, method: POST, path: /govchecks/v1/gh/verify-card, description: 'Ghana: validate Ghana Card against NIA.'}
      - {name: ghverifycardfacematch, method: POST, path: /govchecks/v1/gh/verify-card-facematch, description: 'Ghana: validate Ghana Card with biometric facematch against NIA.'}
      - {name: kebrs, method: POST, path: /govchecks/v1/ke/brs, description: 'Kenya: validate business against BRS.'}
      - {name: keiprs, method: POST, path: /govchecks/v1/ke/iprs, description: 'Kenya: validate national ID against IPRS.'}
      - {name: mxcurp, method: POST, path: /govchecks/v1/mx/curp, description: 'Mexico: validate CURP.'}
      - {name: mxine, method: POST, path: /govchecks/v1/mx/ine, description: 'Mexico: validate INE.'}
      - {name: mxrfc, method: POST, path: /govchecks/v1/mx/rfc, description: 'Mexico: validate CURP and RFC.'}
      - {name: mxrfcstatus, method: POST, path: /govchecks/v1/mx/rfc-status, description: 'Mexico: retrieve RFC tax data.'}
      - {name: mxpep, method: POST, path: /govchecks/v1/mx/pep, description: 'Mexico: Politically Exposed Person check.'}
      - {name: ngnin, method: POST, path: /govchecks/v1/ng/nin, description: 'Nigeria: validate NIN.'}
      - {name: ngvin, method: POST, path: /govchecks/v1/ng/vin, description: 'Nigeria: validate VIN (voter ID).'}
      - {name: ngdl, method: POST, path: /govchecks/v1/ng/dl, description: 'Nigeria: validate Driver License.'}
      - {name: ngcac, method: POST, path: /govchecks/v1/ng/cac, description: 'Nigeria: validate CAC company registration.'}
      - {name: ngtin, method: POST, path: /govchecks/v1/ng/tin, description: 'Nigeria: validate company TIN.'}
      - {name: ngcacaffiliates, method: POST, path: /govchecks/v1/ng/cac-affiliates, description: 'Nigeria: return CAC affiliates / officers for a company.'}
      - {name: patse, method: POST, path: /govchecks/v1/pa/tse, description: 'Panama: validate DNI against TSE.'}
      - {name: patsefacematch, method: POST, path: /govchecks/v1/pa/tse-facematch, description: 'Panama: validate DNI with biometric facematch.'}
      - {name: pyrcp, method: POST, path: /govchecks/v1/py/rcp, description: 'Paraguay: validate Cédula against RCP.'}
      - {name: pegovcheck, method: POST, path: /govchecks/v1/pe/govcheck, description: 'Peru: validate DNI.'}
      - {name: pemigration, method: POST, path: /govchecks/v1/pe/migration-institute, description: 'Peru: check immigration status.'}
      - {name: pesunat, method: POST, path: /govchecks/v1/pe/sunat, description: 'Peru: validate tax status against SUNAT.'}
      - {name: phumidssn, method: POST, path: /govchecks/v1/ph/umid-ssn, description: 'Philippines: validate UMID / SSN.'}
      - {name: uyregistrocivil, method: POST, path: /govchecks/v1/uy/registro-civil, description: 'Uruguay: validate national ID against DGREC.'}
    authentication:
      type: apikey
      key: Authorization
      value: 'Bearer {{env.METAMAP_ACCESS_TOKEN}}'
      placement: header
  exposes:
  - type: mcp
    namespace: metamap-govchecks-mcp
    port: 9090
    transport: http
    description: MCP adapter for MetaMap GovChecks. One tool per country/dataset pair.
    tools:
    - {name: metamap-govcheck-mexico-curp, description: 'Validate a Mexican CURP.', hints: {readOnly: false, destructive: false, idempotent: false}, call: metamap-govchecks.mxcurp, with: {body: tools.body}, outputParameters: [{type: object, mapping: $.}]}
    - {name: metamap-govcheck-mexico-ine, description: 'Validate a Mexican INE.', hints: {readOnly: false, destructive: false, idempotent: false}, call: metamap-govchecks.mxine, with: {body: tools.body}, outputParameters: [{type: object, mapping: $.}]}
    - {name: metamap-govcheck-mexico-rfc, description: 'Validate a Mexican CURP and RFC.', hints: {readOnly: false, destructive: false, idempotent: false}, call: metamap-govchecks.mxrfc, with: {body: tools.body}, outputParameters: [{type: object, mapping: $.}]}
    - {name: metamap-govcheck-mexico-pep, description: 'Mexican PEP check.', hints: {readOnly: false, destructive: false, idempotent: false}, call: metamap-govchecks.mxpep, with: {body: tools.body}, outputParameters: [{type: object, mapping: $.}]}
    - {name: metamap-govcheck-brazil-cpf, description: 'Validate a Brazilian CPF.', hints: {readOnly: false, destructive: false, idempotent: false}, call: metamap-govchecks.brcpfvalidation, with: {body: tools.body}, outputParameters: [{type: object, mapping: $.}]}
    - {name: metamap-govcheck-brazil-cnpj, description: 'Validate a Brazilian CNPJ.', hints: {readOnly: false, destructive: false, idempotent: false}, call: metamap-govchecks.brcnpjextended, with: {body: tools.body}, outputParameters: [{type: object, mapping: $.}]}
    - {name: metamap-govcheck-colombia-govcheck, description: 'Validate a Colombian national ID.', hints: {readOnly: false, destructive: false, idempotent: false}, call: metamap-govchecks.cogovcheck, with: {body: tools.body}, outputParameters: [{type: object, mapping: $.}]}
    - {name: metamap-govcheck-nigeria-nin, description: 'Validate a Nigerian NIN.', hints: {readOnly: false, destructive: false, idempotent: false}, call: metamap-govchecks.ngnin, with: {body: tools.body}, outputParameters: [{type: object, mapping: $.}]}
    - {name: metamap-govcheck-kenya-iprs, description: 'Validate a Kenyan national ID against IPRS.', hints: {readOnly: false, destructive: false, idempotent: false}, call: metamap-govchecks.keiprs, with: {body: tools.body}, outputParameters: [{type: object, mapping: $.}]}
    - {name: metamap-govcheck-ghana-card, description: 'Validate a Ghana Card against NIA.', hints: {readOnly: false, destructive: false, idempotent: false}, call: metamap-govchecks.ghverifycard, with: {body: tools.body}, outputParameters: [{type: object, mapping: $.}]}