Model Context Protocol

Build against DIS without leaving your editor

Connect Cursor, Claude, or VS Code. Search the API catalogue, inspect your applications, and manage playground seed data — using the same login as the developer portal.

Add to Cursor Other clients

CursorClaudeVS CodeCodexWindsurfZed

Agent

Ask DIS…

API catalogue

Search published APIs, switch versions, and pull OpenAPI plus endpoint detail into chat.

Your applications

List apps you already registered and read clientId plus subscribed API versions.

Playground seed data

Read, update, or reset isolated seed tables for an application you own.

Creating apps and live API try-out stay in the developer portal. MCP is a curated wrapper — not a generic API proxy, and not a place for API keys.

Connect your assistant

Pick your client and copy the snippet. The MCP server URL for this environment is already filled in — you do not need to edit it. Sign in with the same account you use on the developer portal.

Filled in from this environment · paste configs as-ishttps://dis-mcp-server.dev.digieconcenter.gov.lk/mcp

Cursor
Claude
VS Code
Other clients

Add to Cursor

Click Add to Cursor, or paste the JSON below as-is into ~/.cursor/mcp.json (or .cursor/mcp.json in a project).
Choose Connect and sign in with the same account you use on the developer portal.
Confirm tools such as search_apis and list_my_applications appear.

~/.cursor/mcp.json
{
  "mcpServers": {
    "dis": {
      "url": "https://dis-mcp-server.dev.digieconcenter.gov.lk/mcp",
      "auth": {
        "CLIENT_ID": "dis-mcp",
        "scopes": [
          "openid",
          "profile",
          "email",
          "offline_access"
        ]
      }
    }
  }
}

Claude Desktop

Open Settings → Connectors → Add custom connector.
Paste the MCP URL: https://dis-mcp-server.dev.digieconcenter.gov.lk/mcp
When asked for an OAuth client ID, enter dis-mcp.
Complete browser login, then fully quit and relaunch Claude Desktop.

If your Claude Desktop build only supports local (stdio) MCP, use the mcp-remote bridge in the Other clients tab.

Claude Code

Add the server, then authenticate when the CLI prompts:

claude mcp add --transport http dis https://dis-mcp-server.dev.digieconcenter.gov.lk/mcp

If login asks for a client ID, enter dis-mcp. You can also drop this JSON into Claude Code MCP settings:

Claude Code MCP config
{
  "mcpServers": {
    "dis": {
      "type": "http",
      "url": "https://dis-mcp-server.dev.digieconcenter.gov.lk/mcp",
      "auth": {
        "CLIENT_ID": "dis-mcp",
        "scopes": [
          "openid",
          "profile",
          "email",
          "offline_access"
        ]
      }
    }
  }
}

Add to VS Code

Click Add to VS Code, or save the JSON below as-is to .vscode/mcp.json. You can also use MCP: Open User Configuration for a global setup.
Start the server, then sign in. If VS Code asks for an OAuth client ID, enter dis-mcp.

.vscode/mcp.json
{
  "servers": {
    "dis": {
      "type": "http",
      "url": "https://dis-mcp-server.dev.digieconcenter.gov.lk/mcp",
      "oauth": {
        "clientId": "dis-mcp"
      }
    }
  }
}

GitHub Copilot Chat in VS Code uses this same MCP configuration. Enable the DIS tools from the chat tool picker after the server connects.

OpenAI Codex

codex mcp add dis --url https://dis-mcp-server.dev.digieconcenter.gov.lk/mcp

Or add this to ~/.codex/config.toml, then run codex mcp login dis:

~/.codex/config.toml
[mcp_servers.dis]
url = "https://dis-mcp-server.dev.digieconcenter.gov.lk/mcp"

Windsurf

Open settings and go to Cascade → MCP servers → Add custom server.
Paste the Cursor-style JSON from the Cursor tab, or use the stdio bridge below.

Zed

Zed settings.json
{
  "context_servers": {
    "dis": {
      "source": "custom",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://dis-mcp-server.dev.digieconcenter.gov.lk/mcp",
        "--static-oauth-client-info",
        "{\"client_id\":\"dis-mcp\"}"
      ],
      "env": {}
    }
  }
}

Any stdio-only host

Clients that cannot speak remote Streamable HTTP can bridge with mcp-remote. Sign in in the browser when prompted. Flag names can change between mcp-remote versions — if OAuth fails, pass client id dis-mcp however that tool currently expects for a static public client.

stdio bridge
{
  "mcpServers": {
    "dis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://dis-mcp-server.dev.digieconcenter.gov.lk/mcp",
        "--static-oauth-client-info",
        "{\"client_id\":\"dis-mcp\"}"
      ]
    }
  }
}

Generic remote MCP

Use Streamable HTTP with this server URL and client id dis-mcp. Sign in with your developer portal account. Do not paste API keys or client secrets into MCP config.

Try it

After the server shows as connected, paste a prompt. For seed data, ask the assistant to call list_my_applications first so it has a clientId.

Discover APIs

Search the DIS catalogue for identity APIs and summarize the published versions, auth methods, and main endpoints.

Inspect my apps

List my applications and show the clientId and subscribed API versions for each one.

Read seed data

For my application, show playground seed tables and a sample of rows. Prefer get_seed_tables then get_seed_table_rows.

Reset playground

Reset playground seed data for this application to the template initial seed, then confirm the table row counts.

Tools

Catalogue

Read only

search_apisSearch published APIs by name or category
get_api_summarySummary for an apiId
get_api_versionsPublished and unpublished (deprecated) versions
get_api_documentationFull OpenAPI for apiId + apiVersionId
get_api_endpointsEndpoint list for a version
get_endpoint_detailEndpoint detail and samples

Applications

Read only

list_my_applicationsid, name, clientId, subscribed apiVersionIds
get_applicationSame fields for one application

Playground seed data

Read / write

get_playground_contextTable names and row counts
get_seed_tablesSummary of tables in the current state
get_seed_table_rowsRows for one table (default 50, max 200)
update_seed_tableReplace one table (max 500 rows)
reset_seed_dataReset isolated client state to the template seed

Seed tools need a clientId from list_my_applications that belongs to your organisation and is subscribed to the requested apiVersionId. Prefer table summaries over dumping the full playground state. Register apps in My Applications.

Limits and troubleshooting

20Max catalogue / app page size

60 / 10Requests / write tools per minute

200Max seed rows returned per read

How sign-in works

Use the same account as the developer portal. Your MCP client opens a browser login, then keeps you signed in for tool calls. You never paste API keys into MCP config.

Connect fails or sign-in errors

Confirm the endpoint on this page, then disconnect and try again. Cursor completes login in the browser using a local callback at http://localhost:8787/callback.

Tools load but applications are empty

Disconnect, reconnect, and sign in again so your organisation is picked up.

401 on every call

Reconnect and complete browser sign-in again. Do not paste an access token by hand.

My client only supports local stdio MCP

Use the mcp-remote bridge under Other clients. Fully quit and relaunch the host after editing config.

Seed tools reject clientId

The application must belong to your organisation and be subscribed to that apiVersionId. Create or subscribe in My Applications.

Build against DIS without leaving your editor

API catalogue

Your applications

Playground seed data

Connect your assistant​

Claude Desktop

Claude Code

OpenAI Codex

Windsurf

Zed

Any stdio-only host

Generic remote MCP

Try it​

Tools​

Catalogue

Applications

Playground seed data

Limits and troubleshooting​

Connect your assistant

Try it

Tools

Limits and troubleshooting