MCP Connector

Vayu MCP Overview

Vayu MCP lets AI assistants connect directly to your Vayu workspace using the Model Context Protocol (MCP).

With it, your team can ask natural-language questions about customers, contracts, invoices, plans, catalog products, meters, credits, and custom field definitions, using live data from Vayu.

What You Can Do With Vayu MCP

Today, Vayu MCP is focused on secure, read-oriented access to billing and revenue data in your Vayu account.

You can use it for finance and billing questions including revenue recognition by period, deferred revenue, waterfall analysis, contract and renewal lookups, overdue AR, invoice status, and cross-entity search.

Available tool groups include customers, contracts, invoices, catalog products, plans, meters, custom fields, and credits.

Tool names are prefixed with vayu_ in MCP clients. List endpoints support pagination, and list results follow the server's supported sorting semantics where available.

Supported AI Clients

Vayu MCP works with MCP-compatible clients, including Claude Desktop, Claude Code, Cursor, claude.ai, MCP Inspector, and other MCP clients that support remote HTTP servers and OAuth-based authentication.

Authentication

Vayu MCP is exposed as an OAuth 2.1 protected resource.

When a compatible MCP client connects to the Vayu MCP endpoint, it discovers the authorization flow automatically through standard protected-resource metadata, including the WWW-Authenticate response header and the /.well-known/oauth-protected-resource metadata document.

From there, the client launches the browser-based sign-in flow and obtains access tokens directly from the configured authorization server, currently Descope.

This means there is no manual token copy and paste for supported clients. Users simply connect to the MCP server and complete sign-in in the browser.

Endpoints

Use the endpoint that matches your environment:

• Staging: https://mcp.staging.withvayu.com/mcp
• Production: https://mcp.withvayu.com/mcp

Connect Claude Desktop

1. Open Claude Desktop MCP settings.
2. Choose Add MCP server.
3. Paste the Vayu MCP server URL.
4. Click Connect.
5. Complete the browser sign-in flow when prompted.

Once connected, Claude Desktop can use the Vayu MCP tools in your conversations.

Example

Find customers named Acme and show me their overdue invoices.

Connect Claude Code

Use the CLI to register the server:

claude mcp add --transport http vayu https://mcp.withvayu.com/mcp

Then follow the sign-in flow when Claude Code prompts for authentication.

Connect Claude.ai

1. Open Settings → Connectors.
2. Choose Add custom connector.
3. Paste the Vayu MCP server URL: https://mcp.withvayu.com/mcp.
4. Click Connect.
5. Complete the browser sign-in flow when prompted.

Once connected, enable the connector in the conversation where you want to use Vayu.

Example Questions to Ask

Example

Which invoices are overdue for Acme?

Example

List contracts renewing in the next 90 days.

Example

What is this customer's current credit balance?

Security and Scope

Vayu MCP is designed to be safe to use in production workflows. Access is scoped to the authenticated Vayu account. The MCP server is read-only and authentication is handled through the OAuth protected-resource flow.

Current Limitations

At this stage, Vayu MCP is best suited for retrieval and analysis workflows.

The current toolset is primarily read-focused. Available data depends on your Vayu account and configuration. Contract billing schedules and usage events are not currently exposed. Client support depends on MCP compatibility and OAuth protected-resource support.

Watch Vayu MCP Connect

This video shows the Vayu MCP connection flow.

Need Help?

If you need help enabling Vayu MCP for your workspace, reach out to your Vayu team contact.