Bring Ipfs
to Mastra AI
Learn how to connect Filebase (Web3 Storage) to Mastra AI and start using 29 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the 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.
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.
How it works
- Subscribe to this server
- Enter your Filebase API Key and Platform Token
- Start managing your Web3 assets from Claude, Cursor, or any MCP-compatible client
Who is this for?
- Web3 Developers — interact with IPFS and IPNS directly from your coding environment without switching to CLI or web dashboards.
- DevOps Engineers — automate pinning and storage monitoring as part of your infrastructure workflows.
- Content Creators — manage decentralized assets and metadata for NFTs or dApps using simple natural language commands.
Built-in capabilities (29)
Create a new dedicated gateway
Create a new IPNS name
Delete a dedicated gateway
Delete an IPNS name
Get storage usage for a specific bucket
Get details of a specific dedicated gateway
Get bandwidth usage for a dedicated gateway
Get details of a specific IPNS name
Get total storage and bandwidth usage
List all dedicated gateways
List all IPNS names
Update a dedicated gateway
Update an IPNS name to point to a new CID
Add a pin using the Pinning Service API
Get pin status by request ID
List pins using the Pinning Service API
Remove a pin by request ID
Replace an existing pin
Add a text file to IPFS
Retrieve a raw block by CID
Fetch contents of a file by CID
Create a new keypair
List all keys in the keychain
Publish a CID to IPNS
Resolve an IPNS name to an IPFS path
Pin a CID to persistent storage
List all pinned objects via RPC
Unpin a CID via RPC
Get the version of the IPFS daemon
Why Mastra AI?
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.
- —
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) in Mastra AI
Filebase (Web3 Storage) and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Filebase (Web3 Storage) to Mastra AI through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for Filebase (Web3 Storage) in Mastra AI
The Filebase (Web3 Storage) 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. All 29 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Mastra AI only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* 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
How Vinkius secures
Filebase (Web3 Storage) for Mastra AI
Every tool call from Mastra AI to the Filebase (Web3 Storage) MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
How do I pin a specific CID to ensure it stays on the network?
You can use the rpc_pin_add tool by providing the CID. This ensures the content is persistently stored on Filebase's IPFS infrastructure.
Can I check my current storage usage and limits?
Yes! Use the platform_get_usage tool. It will return your total storage used, bandwidth metrics, and current subscription limits.
How do I publish a CID to a mutable IPNS name?
Use the rpc_name_publish tool with the target CID. This maps your content to an IPNS address that stays the same even when the content updates.
How does Mastra AI connect to MCP servers?
Create an 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?
Yes. Pass multiple MCP clients to the agent constructor. Mastra merges all tool schemas and the agent can call any tool from any server.
Does Mastra support workflow orchestration?
Yes. Mastra has a built-in workflow engine that lets you chain MCP tool calls with branching logic, error handling, and parallel execution.
createMCPClient not exported
Install: npm install @mastra/mcp
Explore More MCP Servers
View all →
FirstQuadrant
8 toolsLet AI handle your outbound sales prospecting with autonomous research, personalized messaging, and smart follow-up sequences.
H2O.ai
6 toolsManage AI models via H2O.ai — track data frames, monitor machine learning models and training jobs, and audit cloud cluster status directly from any AI agent.
Cloopen / 容联云
10 toolsLeading cloud communication platform in China — manage SMS, voice calls, and applications via AI.
Geocodio
10 toolsEmpower geocoding via Geocodio — perform batch geocoding and reverse geocoding for US/Canada, and retrieve Census and legislative data directly from any AI agent.