1
Get an API Key
Sign up at /signup for a free key (100 calls/day).
2
Browse Toolkits
List available toolkits, optionally filtered by category:
Shell
curl "https://context.gnist.ai/api/toolkits?category=Weather" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/api/toolkits",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={"category": "Weather"},
)
for tk in resp.json()["toolkits"]:
print(f"{tk['slug']}: {tk['description']}")
TypeScript
const resp = await fetch(
"https://context.gnist.ai/api/toolkits?category=Weather",
{ headers: { "Gnist-API-Key": "YOUR_API_KEY" } }
);
const { toolkits } = await resp.json();
toolkits.forEach(tk => console.log(`${tk.slug}: ${tk.description}`));
3
Call a Tool
Each toolkit exposes REST endpoints. Get current weather in Oslo:
Shell
curl "https://context.gnist.ai/api/open-meteo/current?lat=59.91&lon=10.75" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
resp = httpx.get(
"https://context.gnist.ai/api/open-meteo/current",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={"lat": 59.91, "lon": 10.75},
)
print(resp.json()["data"])
4
Use the REST Bridge
Every MCP tool is also available as a POST endpoint via the REST bridge:
Shell
curl -X POST "https://context.gnist.ai/rest/brreg/search_companies" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "Equinor"}'
Full spec at /api/openapi.json. Per-toolkit specs at /toolkits/<slug>/openapi.json.
5
Explore
Browse Toolkits
Find toolkits by category with full API documentation.
/toolkits
OpenAPI Spec
Machine-readable spec for all REST endpoints.
/api/openapi.json
Response Schemas
JSON schemas for all tool inputs and outputs.
/mcp/schemas
Service Status
Live health dashboard for all toolkits.
/mcp/status.html