How to Use the Greenspark MCP in OpenAI Agents SDK

Run production OpenAI Agents SDK setups that programmatically offset carbon and plant trees through Greenspark with built-in safety guardrails.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Greenspark MCP to OpenAI Agents SDK

Create your Vinkius account to connect Greenspark to OpenAI Agents SDK 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 Greenspark with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Transaction Offsets

The `estimate_footprint` tool calculates the carbon footprint of your transactions so your OpenAI Agents SDK configuration can trigger offsets. Your agent evaluates the carbon cost of each order and automatically calls `create_impact` to plant trees. Because you are running the OpenAI Agents SDK, you can track these automated Greenspark tree-planting actions directly inside your OpenAI developer dashboard using built-in guardrails.

Real-Time Impact Badging

The `list_badges` tool retrieves active Greenspark impact widgets to display your environmental milestones inside your OpenAI Agents SDK chat interface. Your agent matches these badges with project details fetched via `get_project` to show users exactly where their trees are planted. The OpenAI Agents SDK manages the handoff between your specialized customer-facing agent and your Greenspark reporting agent, ensuring your tree-planting statistics update without interrupting the user conversation.

Event-Driven Webhooks with MCP Server

The `create_webhook` tool enables your OpenAI Agents SDK setup to listen for live Greenspark impact updates. The agent configures these webhooks to trigger whenever a tree is successfully planted or carbon is offset. Using this MCP Server alongside the OpenAI Agents SDK lets your agent self-configure its own notification pipelines. You don't have to write custom glue code; the agent monitors webhook status using `list_webhooks` and logs every Greenspark event directly to your OpenAI tracing console.

Setup guide

Set up Greenspark MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Greenspark tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Greenspark tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Greenspark tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Greenspark Agent",
            instructions="You have access to Greenspark tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 Greenspark. 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 Greenspark 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 Greenspark MCP in OpenAI Agents SDK

Install the SDK and pass the server HTTP URL to the Agent constructor. Your agent auto-discovers tools like `create_impact` and `estimate_footprint` without any manual schema definitions.

Yes. You can set strict budget guardrails in your agent configuration before it calls `create_impact`. This prevents the agent from triggering high-cost environmental offsets on its own.

The SDK manages token usage and tool execution retries automatically. If `estimate_footprint` hits a rate limit, the SDK handles the backoff policy to ensure your transaction flows don't break.

Yes. The server runs seamlessly in asynchronous contexts, allowing your agent to query historical offsets using `list_impacts` without blocking your primary application thread.

This server only touches numeric transaction amounts and basic category strings to calculate carbon footprints. Your subscription credentials are kept in your local environment, meaning raw payment details and customer names never pass through the server.

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