How to Use the Unpaywall (Open Access Papers) MCP in Mastra AI

Q: How does Unpaywall (Open Access Papers) and Mastra AI handle OA status checks?

You define a workflow step using the getarticleoastatus tool. The agent calls it with a DOI, retrieving the Open Access status and PDF links, which then feeds into the next conditional action.

Q: Can Unpaywall (Open Access Papers) be integrated into complex Mastra AI workflows?

Absolutely. You can use getarticleoastatus as a crucial step in your agent's logic, making the entire process robust against external API failures.

Q: How do I use Unpaywall (Open Access Papers) and Mastra AI to automate research?

Build a workflow that accepts a DOI batch. The agent runs getarticleoastatus for each, implementing retries if necessary, and then aggregates the successful OA results.

Build Reliable Workflows Checking OA Status with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Unpaywall (Open Access Papers) MCP to Mastra AI

Create your Vinkius account to connect Unpaywall (Open Access Papers) to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Unpaywall (Open Access Papers) with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated DOI Verification

The `get_article_oa_status` tool verifies Open Access status for a given DOI. Because you're building complex workflows, this service acts as a reliable data source that doesn't fail when external APIs hiccup. Mastra AI handles the integration, allowing your multi-step process to proceed only if the OA check is successful.

Graceful Failure Handling

Need to retry a DOI lookup? Mastra AI's workflow engine lets you build conditional logic. If the initial call to `get_article_oa_status` fails, the system can automatically implement an exponential backoff and try again. This ensures your complex agent workflows don't crash just because of a temporary network blip.

Managing Multi-Step Research

You can sequence multiple steps: first, check the OA status using `get_article_oa_status`; then, if found, send the link to an admin for review. Mastra AI manages this entire state machine. It's perfect for building automated research pipelines that need precise control over execution flow.

Setup guide

Set up Unpaywall (Open Access Papers) MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Unpaywall (Open Access Papers) tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "unpaywall-open-access-papers-mcp-client",
  servers: {
    "unpaywall-open-access-papers-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Unpaywall (Open Access Papers) Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Unpaywall (Open Access Papers) tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Unpaywall (Open Access Papers) transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Unpaywall. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Unpaywall (Open Access Papers) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Unpaywall (Open Access Papers) MCP in Mastra AI

You define a workflow step using the `get_article_oa_status` tool. The agent calls it with a DOI, retrieving the Open Access status and PDF links, which then feeds into the next conditional action.

Absolutely. You can use `get_article_oa_status` as a crucial step in your agent's logic, making the entire process robust against external API failures.

The core data type is the DOI. The server takes this string, checks it for Open Access status, and provides structured results regarding article location.

Build a workflow that accepts a DOI batch. The agent runs `get_article_oa_status` for each, implementing retries if necessary, and then aggregates the successful OA results.

It handles DOI strings. The server uses these DOIs to query external databases for Open Access status; no user credentials or personal identifiers are stored.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript