Filebase (Web3 Storage) MCP Server for Mastra AIGive Mastra AI instant access to 29 tools to Platform Create Gateway, Platform Create Name, Platform Delete Gateway, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Filebase (Web3 Storage) through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Filebase (Web3 Storage) MCP Server for Mastra AI is a standout in the Developer Tools category — giving your AI agent 29 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"filebase-web3-storage": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Filebase (Web3 Storage) Agent",
instructions:
"You help users interact with Filebase (Web3 Storage) " +
"using 29 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Filebase (Web3 Storage)?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Filebase (Web3 Storage) MCP Server
Connect your Filebase account to any AI agent and take full control of your decentralized Web3 storage workflows through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Filebase (Web3 Storage) tool infrastructure. Connect 29 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- IPFS Operations — Add text files, fetch content by CID, and manage raw blocks directly on the IPFS network using the RPC API.
- Pinning Management — Use the Pinning Service API (PSA) or RPC to pin, list, and remove content identifiers (CIDs) for persistent storage.
- IPNS & Keys — Generate keypairs, publish CIDs to IPNS, and resolve names to IPFS paths for mutable decentralized websites.
- Usage & Infrastructure — Monitor storage usage, manage dedicated gateways, and track bucket metrics across the platform.
The Filebase (Web3 Storage) MCP Server exposes 29 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 29 Filebase (Web3 Storage) tools available for Mastra AI
When Mastra AI connects to Filebase (Web3 Storage) through Vinkius, your AI agent gets direct access to every tool listed below — spanning ipfs, web3, decentralized-storage, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Platform create gateway on Filebase (Web3 Storage)
Create a new dedicated gateway
Platform create name on Filebase (Web3 Storage)
Create a new IPNS name
Platform delete gateway on Filebase (Web3 Storage)
Delete a dedicated gateway
Platform delete name on Filebase (Web3 Storage)
Delete an IPNS name
Platform get bucket usage on Filebase (Web3 Storage)
Get storage usage for a specific bucket
Platform get gateway on Filebase (Web3 Storage)
Get details of a specific dedicated gateway
Platform get gateway usage on Filebase (Web3 Storage)
Get bandwidth usage for a dedicated gateway
Platform get name on Filebase (Web3 Storage)
Get details of a specific IPNS name
Platform get usage on Filebase (Web3 Storage)
Get total storage and bandwidth usage
Platform list gateways on Filebase (Web3 Storage)
List all dedicated gateways
Platform list names on Filebase (Web3 Storage)
List all IPNS names
Platform update gateway on Filebase (Web3 Storage)
Update a dedicated gateway
Platform update name on Filebase (Web3 Storage)
Update an IPNS name to point to a new CID
Psa add pin on Filebase (Web3 Storage)
Add a pin using the Pinning Service API
Psa get pin on Filebase (Web3 Storage)
Get pin status by request ID
Psa list pins on Filebase (Web3 Storage)
List pins using the Pinning Service API
Psa remove pin on Filebase (Web3 Storage)
Remove a pin by request ID
Psa replace pin on Filebase (Web3 Storage)
Replace an existing pin
Rpc add on Filebase (Web3 Storage)
Add a text file to IPFS
Rpc block get on Filebase (Web3 Storage)
Retrieve a raw block by CID
Rpc cat on Filebase (Web3 Storage)
Fetch contents of a file by CID
Rpc key gen on Filebase (Web3 Storage)
Create a new keypair
Rpc key list on Filebase (Web3 Storage)
List all keys in the keychain
Rpc name publish on Filebase (Web3 Storage)
Publish a CID to IPNS
Rpc name resolve on Filebase (Web3 Storage)
Resolve an IPNS name to an IPFS path
Rpc pin add on Filebase (Web3 Storage)
Pin a CID to persistent storage
Rpc pin ls on Filebase (Web3 Storage)
List all pinned objects via RPC
Rpc pin rm on Filebase (Web3 Storage)
Unpin a CID via RPC
Rpc version on Filebase (Web3 Storage)
Get the version of the IPFS daemon
Connect Filebase (Web3 Storage) to Mastra AI via MCP
Follow these steps to wire Filebase (Web3 Storage) into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Filebase (Web3 Storage) MCP Server
Mastra AI provides unique advantages when paired with Filebase (Web3 Storage) through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Filebase (Web3 Storage) without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Filebase (Web3 Storage) tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Filebase (Web3 Storage) + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Filebase (Web3 Storage) MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Filebase (Web3 Storage), process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Filebase (Web3 Storage) as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Filebase (Web3 Storage) on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Filebase (Web3 Storage) tools alongside other MCP servers
Example Prompts for Filebase (Web3 Storage) in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Filebase (Web3 Storage) immediately.
"Upload the text 'Hello from Filebase MCP' to IPFS."
"Show me a list of all my pinned objects."
"What is my current storage usage on Filebase?"
Troubleshooting Filebase (Web3 Storage) MCP Server with Mastra AI
Common issues when connecting Filebase (Web3 Storage) to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpFilebase (Web3 Storage) + Mastra AI FAQ
Common questions about integrating Filebase (Web3 Storage) MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Unleash (Feature Toggles)
11 toolsManage feature flags, strategies, and environments via Unleash — evaluate toggles, list projects, and monitor metrics directly from your AI agent.
Winevybe
10 toolsAutomate sommelier intelligence via Winevybe — search global wine catalogs, check vineyard ratings, and manage virtual cellars directly from any AI agent.
Eurostat Demographics — EU Population & Labor
6 toolsEU demographics and labor market: population by age and sex, monthly unemployment rates, employment data, immigration by citizenship, life expectancy, and minimum wages for all 27 EU member states.
LexisNexis
7 toolsManage your corporate intelligence — audit news, company data, and legal cases via AI.