How to Use the Genius Referrals MCP in VS Code Copilot

Q: How do I give my whole team access to Genius Referrals in VS Code Copilot?

Add the MCP server configuration to a .vscode/mcp.json file in your project's root directory and commit it to Git. Everyone who pulls the repo will automatically have the tools available in VS Code Copilot.

Q: Is it possible to track new conversions from Genius Referrals with VS Code Copilot?

Definitely. You can ask your agent to logreferralconversion to record a new event. You can also ask it to listtrackedreferrals to get a live look at recent conversion events.

Q: How can I check the details of a specific referral campaign?

First, you can get a list of all campaigns with listreferralcampaigns. Then, ask your agent to getcampaigndetails with the specific ID you're interested in. You'll get all the metadata for that campaign.

Equip your entire dev team with Genius Referrals tools inside VS Code Copilot.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Genius Referrals MCP to VS Code Copilot

Create your Vinkius account to connect Genius Referrals to VS Code Copilot 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 Genius Referrals with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Shared Config for Your Team

Here's the main advantage: you add this MCP server's configuration to a `.vscode/mcp.json` file and commit it to your repository. Now, every developer on the team gets the same set of Genius Referrals tools automatically. No more individual setups or version conflicts. When a new developer joins, they clone the repo and instantly have the ability to interact with your referral program data. It standardizes the whole team's workflow.

Pull Reports in VS Code Copilot

Your agent can become a powerful reporting tool. Ask it to `list_tracked_referrals` for the last week and format the output as Markdown. You can paste the result directly into a pull request or a Slack message. This is faster than logging into a web app, exporting a CSV, and cleaning it up. Use your agent to run `list_program_advocates` or `list_awarded_bonuses` to get the exact data you need, formatted how you want it, right in your editor.

Verify Your Setup Instantly

Before you start coding, you can avoid simple mistakes. Just ask your Copilot agent to `verify_api_connection`. It gives you an immediate green light that your credentials are valid and you can reach the Genius Referrals API. You can also have it run `get_my_account` to see exactly which account and user you're authenticated as. This is a critical sanity check to prevent making changes to the production environment by accident.

Setup guide

Set up Genius Referrals MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Genius Referrals MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Genius Referrals tools listed. Try asking: "List my recent Genius Referrals transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "genius-referrals-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 Genius Referrals. 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 Genius Referrals 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 Genius Referrals MCP in VS Code Copilot

Add the MCP server configuration to a `.vscode/mcp.json` file in your project's root directory and commit it to Git. Everyone who pulls the repo will automatically have the tools available in VS Code Copilot.

Yes. Simply switch Copilot Chat to Agent mode and ask it to 'list our top performers.' It will use the `list_top_performers` tool to fetch the data from Genius Referrals and show it to you.

Definitely. You can ask your agent to `log_referral_conversion` to record a new event. You can also ask it to `list_tracked_referrals` to get a live look at recent conversion events.

First, you can get a list of all campaigns with `list_referral_campaigns`. Then, ask your agent to `get_campaign_details` with the specific ID you're interested in. You'll get all the metadata for that campaign.

This server processes requests for advocate records and referral events through Vinkius's SOC 2 compliant infrastructure. Your team connects using a project-specific token, and all operations are executed in ephemeral, single-use sandboxes, ensuring data isn't stored or exposed.

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