Skip to content

Use NeoReader in VS Code and GitHub Copilot

GitHub Copilot in agent mode can call the NeoReader MCP server to create dynamic QR codes, change where they go and check how often they are scanned.

Developers › VS Code and GitHub Copilot

What you can do with it

NeoReader is a QR code generator for dynamic codes: the code holds a short link, neoreader.com/q/SLUG, that redirects to a destination you can change at any time, so a printed code never has to be replaced. The connector is free for members and gives VS Code and GitHub Copilot these tools:

ToolWhat it does
create_codeMakes a dynamic QR code from a title and a destination, or a hosted page (PDF, business card, link list, menu, coupon, event, social media, feedback, location, app, image gallery or video) from a type and its content.
list_codesFinds your codes by search word, folder or status.
update_codeChanges the destination, page content, title, folder, expiry or on/off state.
get_code_statsReads scans by day, country, device, system and browser.
pause_codeStops a code redirecting without deleting it.
delete_codeDeletes a code for good. Only on your say-so.

Before you start

You need a free NeoReader account, VS Code with GitHub Copilot, and MCP support turned on for your organization if you use Copilot Business or Enterprise.

Add the server

Create .vscode/mcp.json in your project, or run MCP: Add Server from the Command Palette and choose HTTP:

{
  "servers": {
    "neoreader": {
      "type": "http",
      "url": "https://neoreader.com/mcp"
    }
  }
}

Choose Start above the server entry. VS Code opens NeoReader in your browser. Sign in, read what the assistant can and cannot do, and choose Allow.

Use an API token instead

If you would rather not sign in through the browser, create a token under Account, then API Tokens, and let VS Code ask for it so it never lands in a file:

{
  "inputs": [
    { "type": "promptString", "id": "neoreader-token", "description": "NeoReader API token", "password": true }
  ],
  "servers": {
    "neoreader": {
      "type": "http",
      "url": "https://neoreader.com/mcp",
      "headers": { "Authorization": "Bearer ${input:neoreader-token}" }
    }
  }
}

Try it

Open Copilot Chat, switch to Agent mode, check that the NeoReader tools are enabled in the tools picker, and ask:

Disconnect

Run MCP: List Servers, choose NeoReader and then Stop or Remove. To end the approval itself, choose Disconnect under Connected Assistants on the NeoReader API Tokens page.

What VS Code and GitHub Copilot can and cannot do

When you connect, NeoReader shows a screen that lists this before you choose Allow. The assistant can create, read, change, pause and delete your dynamic QR codes and read their scan statistics. It cannot see or change your email address, sign-in or account settings, cannot see your API tokens, and cannot go past your account’s code limit. Scans are counted without storing IP addresses. Every action runs as you, so a code that belongs to someone else looks like a code that does not exist.

Troubleshooting

Other ways to connect

The same server works with Claude, ChatGPT, Cursor and Claude Code. If you are writing your own code, use the QR code API and the OpenAPI description. To design the image of a code, use the QR code generator.