Altruistiq · Capability

Altruistiq Datasource API — Location

Geographic reference data (countries and country subdivisions).

Altruistiq Datasource API — Location is a Naftiko capability published by Altruistiq, one of 9 capabilities the APIs.io network indexes for this provider. It bundles 2 operations across the GET method rooted at /v1/location/countries.

The capability includes 2 read-only operations. Lead operation: Get A List Of Countries. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Altruistiq, Location, and Geography.

Run with Naftiko AltruistiqLocationGeography

What You Can Do

GET

Listcountries —

/v1/location/countries

GET

Listsubdivisions —

/v1/location/countries/{countryCode}/subdivisions

MCP Tools

altruistiq-list-countries

Get A List Of Countries

read-only idempotent

altruistiq-list-subdivisions

Get Country Subdivisions By Country Code

read-only idempotent

Capability Spec

naftiko: 1.0.0-alpha2
info:
  label: Altruistiq Datasource API — Location
  description: Geographic reference data (countries and country subdivisions).
  tags:
    - Altruistiq
    - Location
    - Geography
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      ALTRUISTIQ_ACCESS_TOKEN: ALTRUISTIQ_ACCESS_TOKEN
capability:
  consumes:
    - type: http
      namespace: location
      baseUri: https://app.altruistiq.com/api/public/v1
      resources:
        - name: countries
          path: /location/countries
          operations:
            - name: listCountries
              method: GET
              description: Get A List Of Countries
        - name: country-subdivisions
          path: /location/countries/{countryCode}/subdivisions
          operations:
            - name: listSubdivisions
              method: GET
              description: Get Country Subdivisions By Country Code
      authentication:
        type: bearer
        value: '{{env.ALTRUISTIQ_ACCESS_TOKEN}}'
        placement: header
  exposes:
    - type: rest
      namespace: location-rest
      port: 8080
      resources:
        - path: /v1/location/countries
          name: countries
          operations:
            - method: GET
              name: listCountries
              call: location.listCountries
        - path: /v1/location/countries/{countryCode}/subdivisions
          name: country-subdivisions
          operations:
            - method: GET
              name: listSubdivisions
              call: location.listSubdivisions
    - type: mcp
      namespace: location-mcp
      port: 9090
      transport: http
      tools:
        - name: altruistiq-list-countries
          description: Get A List Of Countries
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: location.listCountries
        - name: altruistiq-list-subdivisions
          description: Get Country Subdivisions By Country Code
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: location.listSubdivisions