How to use Solar System with Mastra
Integrate Solar System into your Mastra agent with SettleGrid's per-call billing. No subscriptions, no minimums — pay only for what you use.
About Solar System
Solar System Data. Access solar system body data via Le Systeme Solaire API. List celestial bodies, get details, and filter planets.
About Mastra
Mastra is a TypeScript-first framework for building AI agents and workflows. It provides type-safe tool definitions and composable agent pipelines.
Integration Guide
Install Mastra
npm install mastraGet your SettleGrid API key
Purchase credits for Solar System, then generate an API key from your Consumer Dashboard.
Register Solar System in your Mastra agent
import { Agent, createTool } from "mastra";
import { z } from "zod";
// Define the tool with Zod schema
const solar_systemTool = createTool({
id: "solar_system",
description: "SolarSystem — call via SettleGrid",
inputSchema: z.object({
query: z.string().describe("Input query"),
}),
execute: async ({ context }) => {
const resp = await fetch(
"https://proxy.settlegrid.ai/v1/solar_system",
{
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(`SolarSystem failed: ${resp.status}`);
return resp.json();
},
});
// Create an agent with the tool
const agent = new Agent({
name: "solar_system-agent",
instructions: "Use SolarSystem to accomplish the task.",
model: { provider: "OPEN_AI", name: "gpt-4o" },
tools: { solar_system: solar_systemTool },
});
const result = await agent.generate("Use SolarSystem for this input");Run your agent
Execute your Mastra agent. SettleGrid automatically meters each call to Solar System and deducts from your credit balance. No rate limits beyond your purchased credits.
Pricing
No subscriptions or minimums. Credits never expire. See full pricing details.
Try Solar System
Purchase credits and start using Solar System in your Mastra agent today.
View Solar System →Other Frameworks
Use Solar System with other agent frameworks: