How to Use the Assertible MCP in Claude

Q: Can Claude Desktop sync my local OpenAPI files to Assertible?

Yes, your agent uses syncspecification to upload local specs. You must configure your ASSERTIBLESYNCTOKEN in the environment variables for this tool to work.

Q: How does Assertible handle JSON validation inside Claude Desktop?

The validatejson tool processes Draft 4 schema checks. Your agent handles this locally within the Claude Desktop environment, bypassing the need for external API credentials.

Q: Can I track deployment status using Assertible and Claude Desktop?

Yes, you can run createdeployment to register a new deployment. This action triggers your Assertible test suites automatically, and the status returns directly to your Claude Desktop window.

Trigger Assertible test runs and validate JSON payloads right inside your Claude Desktop chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Assertible MCP to Claude Desktop

Create your Vinkius account to connect Assertible to Claude Desktop 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 Assertible with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Assertible tests using this Claude Desktop MCP Server

`run_service_tests` lets your agent trigger your entire API test suite without leaving Claude Desktop. You write a prompt to check your API status, and Claude Desktop executes the test run immediately. If a specific endpoint fails, your agent uses `run_specific_test` to isolate the bug. You get the raw test results right in the chat panel, letting you debug local issues before pushing code.

Sync specifications and validate payloads locally

`sync_specification` pushes your local OpenAPI or Swagger files straight to Assertible from Claude Desktop. Your agent reads your local directory, grabs the spec file, and updates your assertions instantly. For quick schema checks, `validate_json` runs a Draft 4 schema validation on any raw payload in your chat. This tool requires no MCP configuration for basic use.

Embed live API status badges in your chats

`get_service_status_badge` fetches real-time markdown badges for your Assertible services directly into Claude Desktop. Your agent inserts these visual status indicators right into your conversation. You can also use `get_test_status_badge` to track specific test results during a debugging session. This lets you monitor your remote API health while talking to Claude Desktop.

Setup guide

Set up Assertible MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Assertible MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Assertible MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under assertible-mcp.

json

{
  "mcpServers": {
    "assertible-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Assertible. 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 Assertible 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 Assertible MCP in Claude Desktop

Add the server to your configuration file. Once connected as an MCP tool, ask your agent to run `run_service_tests` for your service ID. The results populate directly in your active chat.

Yes, your agent uses `sync_specification` to upload local specs. You must configure your `ASSERTIBLE_SYNC_TOKEN` in the environment variables for this tool to work.

The `validate_json` tool processes Draft 4 schema checks. Your agent handles this locally within the Claude Desktop environment, bypassing the need for external API credentials.

Yes, you can run `create_deployment` to register a new deployment. This action triggers your Assertible test suites automatically, and the status returns directly to your Claude Desktop window.

Your OpenAPI specifications and sync tokens remain stored locally on your machine. Claude Desktop executes the MCP server as a local subprocess, meaning your deployment credentials never pass through external servers.

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