How to use Rest Countries with Mastra

Integrate Rest Countries into your Mastra agent with SettleGrid's per-call billing. No subscriptions, no minimums — pay only for what you use.

About Rest Countries

REST Countries. Detailed country data including population, languages, currencies, and flags

Data & APIsv1.0.0by Lex Whiting

About Mastra

Mastra is a TypeScript-first framework for building AI agents and workflows. It provides type-safe tool definitions and composable agent pipelines.

TypeScript

Integration Guide

1

Install Mastra

Terminal
npm install mastra
2

Get your SettleGrid API key

Purchase credits for Rest Countries, then generate an API key from your Consumer Dashboard.

3

Register Rest Countries in your Mastra agent

TypeScript
import { Agent, createTool } from "mastra";
import { z } from "zod";

// Define the tool with Zod schema
const rest_countriesTool = createTool({
  id: "rest_countries",
  description: "RestCountries — call via SettleGrid",
  inputSchema: z.object({
    query: z.string().describe("Input query"),
  }),
  execute: async ({ context }) => {
    const resp = await fetch(
      "https://proxy.settlegrid.ai/v1/rest_countries",
      {
        method: "POST",
        headers: {
          "x-api-key": "sg_live_your_key_here",
          "Content-Type": "application/json",
        },
        body: JSON.stringify({ query: context.query }),
      }
    );
    if (!resp.ok) throw new Error(`RestCountries failed: ${resp.status}`);
    return resp.json();
  },
});

// Create an agent with the tool
const agent = new Agent({
  name: "rest_countries-agent",
  instructions: "Use RestCountries to accomplish the task.",
  model: { provider: "OPEN_AI", name: "gpt-4o" },
  tools: { rest_countries: rest_countriesTool },
});

const result = await agent.generate("Use RestCountries for this input");
4

Run your agent

Execute your Mastra agent. SettleGrid automatically meters each call to Rest Countries and deducts from your credit balance. No rate limits beyond your purchased credits.

Pricing

Cost per call1¢

No subscriptions or minimums. Credits never expire. See full pricing details.

Try Rest Countries

Purchase credits and start using Rest Countries in your Mastra agent today.

View Rest Countries →

Other Frameworks

Use Rest Countries with other agent frameworks:

SettleGrid Help

AI-powered support

How can I help?

Ask me anything about SettleGrid