GlianaAI MCP Server
OfficialGlianaAI MCP server gives any MCP client pay-per-call access to 90+ generative AI models plus utility tools (scraping, OCR, market data, chain RPC), with free discovery and paid execution settled per call from a wallet or prepaid key.
Discover models for free —
list_modelsreturns every model's id, category, provider, and per-call price.Quote costs before spending —
get_pricegives the exact cost of one call, including input-dependent pricing (video duration, TTS length).Inspect input shapes —
get_schemareturns a model's required/optional fields and defaults, so you know what to send.Generate media and text (paid) —
generateruns image, video, video-editing, music, speech, or LLM chat models, returning a media URL or assistant text; source files are passed as public URLs (upload local files to/v1/media, ≤40MB).Discover utility tools for free —
list_toolsreads the gateway live to list every utility tool with method, price, example input, and guidance (tools atpriceMicroUsd: 0are free and need no wallet).Run utility tools (mostly paid) —
toolexecutes scraping, screenshots, social cards, OCR, structured extraction, market data, chain RPC, address parsing, and Indonesian reference data endpoints.Run multi-model pipelines (paid) —
recipechains models in one call, e.g.image-to-video,image-to-video-hd,image-to-video-audio,brainrot-video, settling the sum of the steps.Pay without an account — wallet rails (Base/Tempo/Solana USDC) settle the 402 per call non-custodially, with optional per-call and per-day spending caps; a prepaid
gk_key is an alternative.
Allows payment settlement via Solana using USDC for generative AI calls.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GlianaAI MCP Server list all available models"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GlianaAI MCP server
Pay-per-call generative AI for any MCP client (Claude Desktop, Cursor, …). 90+ models — image, video, video editing, music, speech, LLM chat — plus utility, market-data and SEC-filing tools, with no signup and no API key. Paid calls settle per call from your own wallet over MPP / x402.
Browse + price everything for free (
list_models,get_price,get_schema,list_tools).generateruns a model and settles the gateway's 402 from your wallet (USDC on Base). Your private key is read from the client config and never leaves your machine — non-custodial, same model as ai.glianalabs.com.
Tools
Tool | Paid? | Description |
| free | Every model: id, category, provider, per-call price. |
| free | Exact cost of one call (input affects it — video duration, TTS length). |
| free | A model's input fields (required, defaults). |
| paid | Run a model → media URL, or assistant text for chat models. |
| free | Every utility tool: price, HTTP method, example input, guidance. |
| mostly paid | Run one utility tool — scraping, screenshots, social cards, OCR, structured extraction, market data, chain RPC, reference data. |
| paid | Run a multi-model pipeline in one call (e.g. text→image→video). |
| free | The agent's wallet: its Base and Solana addresses to fund, where the key file is, and the spending limits (never the key) |
| free | Prepaid balance left on your |
| the amount you add | Add money to your |
list_tools reads the gateway live, so it is never out of date — which is why this
table doesn't enumerate the utility tools. A written-down list goes stale the moment
a new endpoint ships, and this one had.
Some utility tools are free and need no wallet at all (list_tools reports them
at priceMicroUsd: 0) — currently the Indonesian reference endpoints: official
region data, prayer times, and NIK verification.
File inputs
Models that take a source file (image-to-video, video-to-video, transcription) accept
a public URL in their file field (e.g. image, video_uri). Have a local file?
Upload it first — no key, no payment:
curl -X POST https://api.glianalabs.com/v1/media \
-H "content-type: video/mp4" --data-binary @clip.mp4
# → { "url": "https://api.glianalabs.com/v1/media/<id>.mp4" }Pass the returned url into the model field. Max 40 MB; video / image / audio only.
Related MCP server: omnicall-mcp
Install
Claude Code — install the plugin (bundles this server plus a skill that tells Claude when and how to use it):
/plugin install gliana-ai --marketplace Gliana-Labs/gliana-mcpThen set GLIANA_API_KEY in your shell (see Paying below) and restart Claude
Code. The plugin ships with spending caps of $1 per call and $10 per day; override
them with GLIANA_MAX_PER_CALL_USD / GLIANA_MAX_PER_DAY_USD.
Cursor — one click: Add GlianaAI to Cursor,
then replace gk_your_key in ~/.cursor/mcp.json.
Codex (~/.codex/config.toml):
[mcp_servers.gliana-ai]
command = "npx"
args = ["-y", "gliana-ai-mcp"]
env = { GLIANA_API_KEY = "gk_your_key", GLIANA_MAX_PER_CALL_USD = "1", GLIANA_MAX_PER_DAY_USD = "10" }Claude Desktop (claude_desktop_config.json) and any other MCP client:
{
"mcpServers": {
"gliana-ai": {
"command": "npx",
"args": ["-y", "gliana-ai-mcp"],
"env": {
"GLIANA_API_KEY": "gk_your_key",
"GLIANA_MAX_PER_CALL_USD": "1",
"GLIANA_MAX_PER_DAY_USD": "10"
}
}
}
}Paying
Two ways. Pick the first one unless you specifically want the second.
1. Prepaid key — no wallet, no private key
"env": { "GLIANA_API_KEY": "gk_your_key" }Sign in at dashboard.glianalabs.com with a Google account, mint a key, and top it up (card, or bank transfer / QRIS in rupiah). This is the one route that needs an account — option 2 below needs none at all.
Paid calls then return 200 directly — no 402 handshake, nothing signed, no
chain, no gas, and nothing in your config that can spend more than you loaded.
Each key carries a daily cap on top of its balance.
So the trade is: an account, in exchange for never putting a private key in a config file.
get_balance (free) reports what is left, and every paid call appends the
remaining balance to its result.
2. Your own wallet — pay per call from your own USDC
The non-custodial route: the gateway's 402 is settled by a signature made on your machine. No account, no signup, no balance held by us — that is the whole point of it.
The cost is that a private key has to live in your MCP client's config, which is a fair thing for a reviewer to refuse. If that is a problem, use the prepaid key above.
Use a dedicated wallet, funded with only what you intend to spend. This server signs payments locally — the key never leaves your machine and is never sent to us — but it is still a private key on a machine running an AI agent. Do not use a wallet that holds anything you would miss.
Prefer
*_KEY_FILEover the inline variable. Your MCP client config gets synced to cloud storage, committed by accident, and screenshotted when you ask someone for help. A file youchmod 600does not:printf '%s' '0xYOUR_KEY' > ~/.gliana-wallet.key && chmod 600 ~/.gliana-wallet.keyInline still works if you prefer it — the server just warns on stderr.
Rail | Env var | Wallet needs |
base (default) |
| USDC on Base — gasless EIP-3009 signature |
tempo | same key as base | USDC on Tempo |
solana |
| USDC on Solana |
GLIANA_RAIL—base|tempo|solana. Optional; defaults tobase(orsolanaif only a Solana key is set). The wallet must hold USDC on that chain.GLIANA_API_URL— optional, defaults tohttps://api.glianalabs.com.
If both are set, the prepaid key wins and the server says so on startup.
That matches the gateway's own rule — a gk_ key is something you attached
deliberately, so it should be what spends — and it means a leftover wallet key
in your config cannot quietly become the thing paying.
Neither is needed for the discovery tools or for the free utility tools that
list_tools reports at priceMicroUsd: 0.
Spending caps
"env": { "GLIANA_MAX_PER_CALL_USD": "1", "GLIANA_MAX_PER_DAY_USD": "10" }Both optional. When set, every paid call is priced before anything is paid — from the gateway's own 402 quote, the same number it would bill — and refused if it would exceed either cap. A refusal costs nothing and says which cap it hit.
Works on every rail. On a wallet rail the check runs on the 402 challenge before it is signed; on the prepaid key it costs one extra free request.
The day total is kept in
~/.gliana-ai-mcp/spend.json, so restarting the client does not reset it. The prepaid key also has its own server-side daily cap.An agent in a loop, or one talked into a 30-second 1080p video, is exactly what these are for. With a wallet rail there is otherwise no ceiling but the balance.
Restart the client. Ask it to "list GlianaAI models" or "generate an image of a red fox with nano-banana-2".
watch — poll one endpoint on a timer
The MCP server answers a client's questions. watch is the other shape: a loop
that calls one cheap endpoint on a schedule and pays per call from the same
wallet, printing one JSON line per poll so it composes with jq or a log drain.
# What would it cost? Reads the live 402 quote, pays nothing, needs no wallet.
npx gliana-ai-mcp watch --tool token-price --input '{"symbol":"SOL"}' \
--budget 0.50 --dry-run
# → {"costUsd":0.002,"pollsAffordable":250,"runtimeHours":4.17}
# What is worth polling, with live prices?
npx gliana-ai-mcp watch --list
# Run it.
npx gliana-ai-mcp watch --tool token-price --input '{"symbol":"SOL"}' \
--every 60 --budget 0.50
# → {"t":"...","call":1,"costUsd":0.002,"spentUsd":0.002,"result":{...}}watch pays from a wallet (--rail base or --rail solana), not from a
prepaid key — see "Why the x402 rail" below.
--budget <usd> is required and is a hard stop — there is no default,
because an unbounded spend loop is not something this command will do on your
behalf. Before every poll it checks the budget against the live quote, so a
price change is picked up immediately rather than at the price it started with.
A call that fails after the money may already have moved is counted as spent and
is never retried, since paying twice for one answer is worse than missing a tick.
Ctrl-C prints a summary.
Payment goes over the x402 rail (/x402/tools/<name>) rather than /v1. Same
price and same handler; the difference is that x402 settles through a public
facilitator, so the calls are independently verifiable and not just visible to
us. --rail base (default with GLIANA_WALLET_KEY) or --rail solana.
Funding
Pay with a NEAR account (no EVM key at all). Set GLIANA_NEAR_KEY_FILE to a
{"account_id":"…","private_key":"ed25519:…"} file. NEAR Chain Signatures sign each
Base USDC payment; the Base address is derived from the account (the wallet tool
shows it). Add GLIANA_NEAR_ALLOWANCE=allowance.<you> to pay through an
agent-allowance contract:
then the key is the agent's and may only ask, and the contract signs only to the
payees, per-payment and daily limits its owner set. The account needs ~0.35 NEAR
for signing gas (mostly refunded); each payment takes ~15-20 s.
GLIANA_NEAR_NETWORK=testnet for testnet.
A payment the allowance holds for its owner waits up to 4 minutes for their approval (GLIANA_NEAR_HOLD_WAIT_S), then says nothing was paid.
Ask the user for a budget instead (Saku, opt-in). With no key configured, ask the agent to "set up a Saku budget".
The saku_setup tool makes a NEAR key for the agent on this machine (~/.gliana/saku.json, owner-only; only the public
half leaves it) and answers with a link. The user opens it, sets the limits and the sellers, and confirms one transaction
in their own NEAR wallet (about 3 NEAR on testnet: 2.5 is the contract's storage, the rest the agent's gas). Call the tool
again, restart the client, and payments go through the user's allowance, which signs only within their rules: a stolen
agent key is worth one day's budget at most. The trade-off: each payment takes ~15-20 s, and one over the limits or to a
new seller waits for the user. A key set in the config always wins over saku.json; delete the file to stop using it.
Testnet for now (mainnet opens after an audit).
The agent's own wallet (no key to paste). Start the server with no wallet key
and it makes one: a Base and a Solana key in ~/.gliana/wallet.json (or
GLIANA_WALLET_FILE), readable only by you, never sent anywhere, never shown by
any tool. Call wallet for its addresses and send it a few dollars of USDC on
Base (paying needs no ETH) or Solana. It starts with limits of $1 a call and $5
a day; set GLIANA_MAX_PER_CALL_USD / GLIANA_MAX_PER_DAY_USD to change them.
Set
GLIANA_PASSPHRASEbefore the first start to encrypt the file (scrypt + AES-256-GCM); the same passphrase is then needed on every start.Back the file up. It is the only copy of the keys: lose it and the USDC in the wallet is gone. An existing file is never overwritten.
GLIANA_NO_AUTO_WALLET=1turns this off. A configuredGLIANA_WALLET_KEY/GLIANA_SOLANA_KEYalways wins over the file.
With a prepaid key, top up at dashboard.glianalabs.com
and check what is left with get_balance.
With a wallet, fund it with a few dollars of USDC on your chosen chain (Base, Tempo, or Solana).
Either way you pay only the per-call price (see get_price) — no subscription.
Use a dedicated low-balance wallet for agents. Never paste your main wallet's key into any config.
Links
Website: https://ai.glianalabs.com
API docs: https://ai.glianalabs.com/docs
MIT © Gliana Labs
Available Tools
7 toolsgenerateA
Run a model and return the result — a media URL for image/video/audio/music models, assistant text for text (LLM) models. Text models take OpenAI-style input: { messages: [{ role, content }, …], max_tokens? }. PAID: settles the price from your wallet over the configured rail (base/tempo/solana). Call get_schema first for the input shape, get_price for the cost. File inputs (image/video/audio, e.g. image-to-video or video-to-video video_uri) take a public URL — upload a local file with POST /v1/media (≤40MB) to get one. Array file fields (e.g. images, reference_images for multi-reference models) take an ARRAY of such URLs.
Inputs: input (required), model (required). Returns: url, rail, model, output, +2 more
get_priceARead-only
Quote the exact cost of one call for a model (optionally with input that affects price, e.g. video duration or TTS character count). Free.
Inputs: model (required), input. Returns: unit, model, units, costUsd, +1 more
get_schemaARead-only
Get a model’s input fields (names, types, which are required, defaults). Use before generate to know what to send. Free.
Inputs: model (required). Returns: model, props, category, required
list_modelsARead-only
List every GlianaAI model (id, category, provider, per-call price). Free — no payment. Use this to pick a model before get_price/generate.
Inputs: no named parameters. Returns: count, models
list_toolsARead-only
List every GlianaAI utility tool (name, HTTP method, per-call price, an example input, and usage guidance), read live from the gateway so it is always current. Free — no payment. Call this before tool to pick one and learn its input shape. Tools reported at priceMicroUsd 0 are free to call and need no wallet.
Inputs: no named parameters. Returns: tools
recipeA
Run a paid multi-model RECIPE pipeline (chains models in one call). PAID: settles the SUM of the steps from your wallet (base/tempo/solana). Recipes: image-to-video {prompt,motionPrompt?} text→image→animated video (3-8x cheaper than a native text-to-video model), image-to-video-hd (crisper still), image-to-video-audio (video with sound), brainrot-video {motionPrompt?,reference_image?} random Italian-brainrot creature → video with audio (no prompt). Override steps with { imageModel, videoModel }. See https://ai.glianalabs.com/docs#recipes.
Inputs: args (required), name (required). Returns: url, rail, recipe, result, +2 more
toolA
Run a UTILITY tool (not an AI model) — scraping, screenshots, social cards, market data, chain RPC, OCR, address parsing, structured extraction, Indonesian reference data. Call list_tools FIRST for the live list with prices and input shapes: it is read from the gateway, so it is never out of date, and this description deliberately does not enumerate them. Most tools are PAID and settle a flat price from your wallet (base/tempo/solana); the ones list_tools reports at priceMicroUsd 0 are free and need no wallet at all.
Inputs: args (required), name (required). Returns: rail, tool, result, costUsd, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct concern: listing models vs. listing utility tools, pricing vs. schema vs. generation, and single-model generation vs. multi-model recipes. There is no meaningful overlap that would confuse an agent.
Most tools follow a verb_noun pattern (list_models, get_price, get_schema, list_tools), but 'generate' is verb-only and 'tool' and 'recipe' are bare nouns. The mix is readable but not uniformly consistent.
Seven tools is well-scoped for a server that covers both AI model access and utility tool execution. Each tool has a clear role without redundancy or bloat.
Core workflows (list, price, schema, generate, run utility, run recipe) are covered. However, file upload for media inputs is only available via an external HTTP endpoint, not an MCP tool, and there is no wallet management tool, leaving minor gaps.
Maintenance
Related MCP Connectors
Pay-per-call APIs via x402 USDC on Base. Hosted MCP: original gateway; stdio: full catalog.
Pay-per-call x402 MCP for AI agents: 35 tools, USDC on Base, from $0.001/call, no API keys.
Pay-per-use MCP tools for AI agents. USDC on Base via x402. No API keys.
Production-grade MCP gateway delivering 8 real-time AI tools with instant x402 micropayments settled in USDC on Base Mainnet or SPL-USDC on Solana. Features Basescan contract auditing, wallet analytics, headless browser scraping, and pre-scraped oracle data feeds.
Related MCP Servers
- AlicenseAqualityDmaintenanceThe MCP gateway that lets any AI agent discover and pay metered APIs on Base or Solana — without the user wiring payments themselves.323 npm1Apache 2.0
- FlicenseNot gradedqualityCmaintenanceKeyless, pay-per-call AI gateway: 248 LLMs plus image/video/voice/music generation and live crypto, DeFi, markets, web-search and research tools through one MCP server. Pay per call in USDC via x402 on Base/Solana — no API key, no signup, free tier.-
- AlicenseNot gradedqualityDmaintenance55+ pay-per-call tools for AI agents over MCP: live telemetry, blockchain/on-chain checks, environmental, transit, finance, and network utilities. No API key or signup — agents pay per request with x402 USDC micropayments (Base and Solana).MIT

halowerk-mcpofficial
AlicenseAqualityDmaintenanceProvides access to 70 paid APIs as MCP tools with per-call and session budgets, paying via x402/USDC on Base without requiring an account or login. Includes a built-in allowlist of hosts and safe defaults to prevent unintended payments.1482 npmMIT