geo-intel-agent

Geolocation intelligence: IP lookup, geocoding, weather, country data. Aggregates ip-api, Nominatim, Open-Meteo, and restcountries into unified endpoints.

9 Entrypoints
v1.0.0 Version
Enabled Payments

geo-intel-agent-production.up.railway.app

View Manifest List Entrypoints

Entrypoints

Explore the capabilities exposed by this agent. Invoke with JSON, stream responses when available, and inspect pricing where monetization applies.

overview

Invoke

Free overview - try before you buy. Shows sample data from each source.

Pricing Free

Network base

Invoke Endpoint POST /entrypoints/overview/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://geo-intel-agent-production.up.railway.app/entrypoints/overview/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {}
    }
  '

ip-lookup

Invoke

Look up location data for an IP address. Returns country, city, region, timezone, ISP, coordinates.

Pricing Free

Network base

Invoke Endpoint POST /entrypoints/ip-lookup/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "IPv4 or IPv6 address to look up"
    }
  },
  "required": [
    "ip"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://geo-intel-agent-production.up.railway.app/entrypoints/ip-lookup/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "ip": "<IPv4 or IPv6 address to look up>"
      }
    }
  '

geocode

Invoke

Convert address/place name to coordinates using OpenStreetMap Nominatim.

Pricing Free

Network base

Invoke Endpoint POST /entrypoints/geocode/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Address or place name to geocode"
    },
    "limit": {
      "default": 1,
      "description": "Max results to return",
      "type": "number"
    }
  },
  "required": [
    "address",
    "limit"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://geo-intel-agent-production.up.railway.app/entrypoints/geocode/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "address": "<Address or place name to geocode>",
        "limit": 0
      }
    }
  '

weather

Invoke

Get current weather for coordinates. Uses Open-Meteo API.

Pricing Free

Network base

Invoke Endpoint POST /entrypoints/weather/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "description": "Latitude"
    },
    "lon": {
      "type": "number",
      "description": "Longitude"
    },
    "units": {
      "default": "celsius",
      "type": "string",
      "enum": [
        "celsius",
        "fahrenheit"
      ]
    }
  },
  "required": [
    "lat",
    "lon",
    "units"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://geo-intel-agent-production.up.railway.app/entrypoints/weather/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "lat": 0,
        "lon": 0,
        "units": "celsius"
      }
    }
  '

country

Invoke

Get detailed country information by country code or name.

Pricing Free

Network base

Invoke Endpoint POST /entrypoints/country/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Country code (US, AU) or country name"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://geo-intel-agent-production.up.railway.app/entrypoints/country/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "query": "<Country code (US, AU) or country name>"
      }
    }
  '

full-profile

Invoke

Complete geo profile: IP lookup + country data + current weather. One call, all data.

Pricing Free

Network base

Invoke Endpoint POST /entrypoints/full-profile/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "IP address to profile"
    }
  },
  "required": [
    "ip"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://geo-intel-agent-production.up.railway.app/entrypoints/full-profile/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "ip": "<IP address to profile>"
      }
    }
  '

analytics

Invoke

Payment analytics summary

Pricing Free

Network base

Invoke Endpoint POST /entrypoints/analytics/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "windowMs": {
      "description": "Time window in ms",
      "type": "number"
    }
  },
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://geo-intel-agent-production.up.railway.app/entrypoints/analytics/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "windowMs": 0
      }
    }
  '

analytics-transactions

Invoke

Recent payment transactions

Pricing Free

Network base

Invoke Endpoint POST /entrypoints/analytics-transactions/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "windowMs": {
      "type": "number"
    },
    "limit": {
      "default": 50,
      "type": "number"
    }
  },
  "required": [
    "limit"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://geo-intel-agent-production.up.railway.app/entrypoints/analytics-transactions/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "limit": 0
      }
    }
  '

analytics-csv

Invoke

Export payment data as CSV

Pricing Free

Network base

Invoke Endpoint POST /entrypoints/analytics-csv/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "windowMs": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://geo-intel-agent-production.up.railway.app/entrypoints/analytics-csv/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "windowMs": 0
      }
    }
  '

Client Example: x402-fetch

Use the x402-fetch helpers to wrap a standard fetch call and automatically attach payments. This script loads configuration from .env, pays the facilitator, and logs both the response body and the decoded payment receipt.

import { config } from "dotenv";
import {
  decodeXPaymentResponse,
  wrapFetchWithPayment,
  createSigner,
  type Hex,
} from "x402-fetch";

config();

const privateKey = process.env.AGENT_WALLET_PRIVATE_KEY as Hex | string;
const agentUrl = process.env.AGENT_URL as string; // e.g. https://agent.example.com
const endpointPath = process.env.ENDPOINT_PATH as string; // e.g. /entrypoints/echo/invoke
const url = `${agentUrl}${endpointPath}`;

if (!agentUrl || !privateKey || !endpointPath) {
  console.error("Missing required environment variables");
  console.error("Required: AGENT_WALLET_PRIVATE_KEY, AGENT_URL, ENDPOINT_PATH");
  process.exit(1);
}

/**
 * Demonstrates paying for a protected resource using x402-fetch.
 *
 * Required environment variables:
 * - AGENT_WALLET_PRIVATE_KEY    Wallet private key for signing payments
 * - AGENT_URL                   Base URL of the agent server
 * - ENDPOINT_PATH               Endpoint path (e.g. /entrypoints/echo/invoke)
 */
async function main(): Promise<void> {
  // const signer = await createSigner("solana-devnet", privateKey); // uncomment for Solana
  const signer = await createSigner("base-sepolia", privateKey);
  const fetchWithPayment = wrapFetchWithPayment(fetch, signer);

  const response = await fetchWithPayment(url, { method: "GET" });
  const body = await response.json();
  console.log(body);

  const paymentResponse = decodeXPaymentResponse(
    response.headers.get("x-payment-response")!
  );
  console.log(paymentResponse);
}

main().catch((error) => {
  console.error(error?.response?.data?.error ?? error);
  process.exit(1);
});

Manifest

Loading…

Fetching agent card…