Linkwarden MCP Server for OpenAI Agents SDKGive OpenAI Agents SDK instant access to 32 tools to Archive Link, Auth Forgot Password, Auth Reset Password, and more
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Linkwarden through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
Ask AI about this MCP Server for OpenAI Agents SDK
The Linkwarden MCP Server for OpenAI Agents SDK is a standout in the Productivity category — giving your AI agent 32 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="Linkwarden Assistant",
instructions=(
"You help users interact with Linkwarden. "
"You have access to 32 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from Linkwarden"
)
print(result.final_output)
asyncio.run(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 Linkwarden MCP Server
Connect your Linkwarden instance to any AI agent and take full control of your personal knowledge base through natural conversation. Linkwarden is a self-hosted collaborative bookmark manager to collect, organize, and preserve webpages.
The OpenAI Agents SDK auto-discovers all 32 tools from Linkwarden through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Linkwarden, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
What you can do
- Collection Management — List all your collections, create new ones, and organize your bookmarks into logical folders.
- Web Archiving — Retrieve preserved archive files for your links to ensure you never lose access to important information, even if the original site goes down.
- Dashboard Insights — Access your dashboard data (v1 and v2) to get a high-level overview of your saved content and activity.
- Link Operations — Create, update, and manage links and their associated metadata or highlights directly from the chat.
- System Configuration — Quickly retrieve public runtime configurations and user profile information.
The Linkwarden MCP Server exposes 32 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 32 Linkwarden tools available for OpenAI Agents SDK
When OpenAI Agents SDK connects to Linkwarden through Vinkius, your AI agent gets direct access to every tool listed below — spanning bookmark-manager, web-archiving, link-organization, 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.
Archive link on Linkwarden
Archive a link (triggers an update of the link's archive files)
Auth forgot password on Linkwarden
Send password reset email
Auth reset password on Linkwarden
Reset password with token
Auth verify email on Linkwarden
Verify email address
Bulk update links on Linkwarden
Bulk update links (tags/collections)
Create collection on Linkwarden
Create a new collection
Create highlight on Linkwarden
Create or update a highlight
Create link on Linkwarden
Create a new link
Delete collection on Linkwarden
Delete a collection
Delete highlight on Linkwarden
Delete a highlight
Get archive on Linkwarden
Retrieve an archive file by link ID
Get avatar on Linkwarden
Retrieve user avatar
Get collection on Linkwarden
Get collection by ID
Get config on Linkwarden
Retrieve public runtime configuration
Get dashboard v1 on Linkwarden
Get dashboard data (v1)
Get dashboard v2 on Linkwarden
Get dashboard data (v2)
Get link on Linkwarden
Get a link by ID
Get link highlights on Linkwarden
Get highlights for a link
Get logins on Linkwarden
Get login configuration
Get migration on Linkwarden
Retrieve migration data (user info, collections, links for export)
Get preserved token on Linkwarden
Create short-lived preserved format URL token
Get public collection links on Linkwarden
Retrieve links from a specific collection (public)
Get public collection tags on Linkwarden
Get tags for a collection (public)
Import migration on Linkwarden
Import data for migration
List collections on Linkwarden
Get all collections
List rss on Linkwarden
List RSS subscriptions
Stream preserved view on Linkwarden
Stream archived format
Update collection on Linkwarden
Update a collection
Update dashboard v2 on Linkwarden
Update dashboard layout (v2)
Update link on Linkwarden
Update a link
Upload archive for link on Linkwarden
Upload or replace a client-side archive file for a specific link
Upload standalone archive on Linkwarden
Upload an archive file, create a new link, and store it in the default collection
Connect Linkwarden to OpenAI Agents SDK via MCP
Follow these steps to wire Linkwarden into OpenAI Agents SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install the SDK
pip install openai-agents in your Python environmentReplace the token
[YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.comRun the script
python agent.pyExplore tools
Why Use OpenAI Agents SDK with the Linkwarden MCP Server
OpenAI Agents SDK provides unique advantages when paired with Linkwarden through the Model Context Protocol.
Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
Linkwarden + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the Linkwarden MCP Server delivers measurable value.
Automated workflows: build agents that query Linkwarden, process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries Linkwarden, another analyzes results, a third generates reports
Data enrichment pipelines: stream data through Linkwarden tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query Linkwarden to resolve tickets, look up records, and update statuses without human intervention
Example Prompts for Linkwarden in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Linkwarden immediately.
"List all my Linkwarden collections."
"Create a new collection called 'Project Alpha' with ID 'alpha-01'."
"Show me my dashboard summary."
Troubleshooting Linkwarden MCP Server with OpenAI Agents SDK
Common issues when connecting Linkwarden to OpenAI Agents SDK through Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
Linkwarden + OpenAI Agents SDK FAQ
Common questions about integrating Linkwarden MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Explore More MCP Servers
View all →
Worktile
10 toolsCollaborative project management and team communication platform — manage tasks, projects, and messages via AI.

Holded
12 toolsRun your business in Spain and Latin America with invoicing, accounting, CRM, and inventory that speaks your language natively.

Banco Inter
8 toolsConnect to your Banco Inter Empresas digital account. Automate Pix, Boletos, balance inquiries and statements.

HealthData.gov (HHS Open Data)
2 toolsAccess and query thousands of U.S. health datasets from HHS — browse the catalog and perform deep data analysis via SoQL.
