Bring Authorization
to Windsurf
Learn how to connect Permit.io to Windsurf and start using 18 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 Permit.io MCP Server?
Connect your Permit.io account to any AI agent to manage your application's authorization layer through natural language. This server allows you to evaluate permissions, manage your authorization schema, and handle user facts without touching code.
What you can do
- Policy Evaluation — Instantly check if a user is permitted to perform specific actions on resources using the
check_permissiontool. - Schema Management — Create resources, define roles, and assign permissions dynamically to build RBAC or ReBAC (Relationship-Based Access Control) structures.
- Fact Management — Provision users and tenants directly into your authorization environment to keep your permission data in sync.
- AuthZen Compatibility — Use standardized AuthZen evaluation tools for interoperable access control checks.
- ReBAC Relations — Define complex relationships between resources to handle hierarchical or ownership-based permissions.
How it works
- Subscribe to this server
- Enter your Permit.io API Key (and optionally your PDP URL)
- Start managing your authorization policies from Claude, Cursor, or any MCP-compatible client
Who is this for?
- Developers — Quickly test authorization logic or provision test users and roles without leaving the IDE.
- Security Engineers — Audit and update access control policies through a conversational interface.
- Product Managers — Define new feature permissions and roles as part of the product requirements workflow.
Built-in capabilities (18)
Assign permissions to a role
Assign a role to a user in a tenant
AuthZen Access Evaluation
AuthZen Action Search
AuthZen Bulk Evaluations
AuthZen Resource Search
AuthZen Subject Search
Bulk assign roles (max 2000)
Bulk create tenants (max 2000)
Bulk create users (max 3000)
Bulk create relationship tuples (max 1000)
Check if a user is permitted to perform an action on a resource
Create a ReBAC relation between resources
Create a ReBAC relationship tuple
Create a new resource in the schema
Create a new role in the schema
Create a new tenant fact
Create a new user fact
Why Windsurf?
Windsurf's Cascade agent chains multiple Permit.io tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 18 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
- —
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
- —
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
- —
JSON-based configuration means zero code changes: paste a URL, reload, and all 18 tools are immediately available
- —
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
Permit.io in Windsurf
Permit.io and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Permit.io to Windsurf 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 Permit.io in Windsurf
The Permit.io 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 18 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Windsurf 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
Permit.io for Windsurf
Every tool call from Windsurf to the Permit.io 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 check if a specific user has permission to access a resource?
Use the check_permission tool. You need to provide the user identifier, the action (e.g., 'read'), and the resource object (including type and tenant). The agent will query your PDP and return the authorization decision.
Can I create new roles and assign permissions to them using this server?
Yes. You can use create_role to define a new role in your schema and then use assign_permissions_to_role to specify exactly what that role is allowed to do within a project and environment.
Does this integration support AuthZen standards?
Yes, it includes several tools like authzen_access_evaluation and authzen_bulk_evaluations to perform authorization checks following the AuthZen specification.
How does Windsurf discover MCP tools?
Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.
Can Cascade chain multiple MCP tool calls?
Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.
Does Windsurf support multiple MCP servers?
Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.
Server not connecting
Check Settings → MCP for the server status. Try toggling it off and on.
Explore More MCP Servers
View all →
Cloudflare
25 toolsAI edge infrastructure: manage Workers, KV, D1, R2, routes, and deployments via agents.
Portainer
6 toolsManage Docker containers and environments via Portainer — list, create, and start containers directly from your AI agent.
Siteminder
18 toolsManage hotel inventory, search properties, and handle reservations via Siteminder's Channels Plus and Direct Booking APIs.
ScrapingBee
10 toolsScrape websites without getting blocked using headless browsers, proxy rotation, and JavaScript rendering handled for you.