---
product: Chilkat
product_version: 11.7.0
language: xbase
language_label: Xbase++
class: Mcp
license: bundle
deprecated: false
reference_html: https://www.chilkatsoft.com/refdoc/xbase_McpRef.html
---
# Chilkat Mcp — Xbase++ — v11.7.0

> Chilkat 11.7.0 · language=xbase · class=Mcp
> Other versions: replace `11.7.0` in this URL. Other languages: `https://www.chilkatsoft.com/ai-docs/v/11.7.0/<lang>/classes/Mcp.md`.
> Language-wide rules (install, unlock, error model, strings/bytes): `https://www.chilkatsoft.com/ai-docs/v/11.7.0/xbase/guide.md`.

## Purpose

**A client for the Model Context Protocol (MCP).**

`Chilkat.Mcp` connects to an MCP server and gives an application access to the server's **tools**, **resources**, and **prompts** over a single, unified API. MCP is an open protocol that standardizes how applications supply context and callable tools to AI models.

**Connect & handshake**

`Connect` opens a Streamable HTTP session and performs the MCP `initialize` handshake, negotiating the protocol version and establishing a session id.

**Tools**

List the server's tools with `ListTools` and invoke them with `CallTool`.

**Resources & prompts**

Read resources with `ListResources` and `ReadResource`, and fetch prompts with `ListPrompts` and `GetPrompt`.

**Use with Chilkat.Ai**

Pass a connected `Chilkat.Mcp` to `Chilkat.Ai.UseMcp` to register the server's tools with an AI model. During a conversation the model's tool calls are routed to the MCP server automatically.

**Transport:** This class uses the MCP `Streamable HTTP` transport (protocol version `2025-06-18`). A server response may arrive as a single JSON object or as a Server-Sent-Events stream; both are handled transparently. The stdio transport is not supported.

**Authentication:** If the MCP server requires authorization, set the `AuthToken` property before calling `Connect`. Chilkat then sends it as an `Authorization: Bearer <token>` header on every request. Leave it unset for servers that do not require authentication.

**Pagination:** When a server has more items than fit in a single response, the `tools/list`, `resources/list`, and `prompts/list` results include a `nextCursor` string. In this release the list methods return the first page only and do not accept a cursor argument, so `nextCursor` is informational.

## Object creation, unlocking and error handling

**Object Creation**

```xbase
LOCAL oMcp
oMcp := CreateObject("Chilkat.Mcp")

// ... use oMcp ...

oMcp:destroy()
```

Xbase++ uses the Chilkat ActiveX through the automation object returned by `CreateObject()`; properties and methods are accessed with the send operator (`oHttp:ConnectTimeout := 30`, `oHttp:Download(cUrl, cPath)`), and `:destroy()` releases the object. Register the Chilkat ActiveX matching the bitness of your Xbase++ application. To bind to a specific major version of Chilkat, append the major version number to the ProgID, such as `CreateObject("Chilkat.Mcp.11")` for Chilkat v11.\*.\*.

Boolean properties, arguments and return values are integers in the ActiveX: pass `1` or `0`, and test a method's success with `== 1`. A method that fails to return an object returns `NIL`. Objects returned by methods (such as an `HttpResponse` or `JsonObject`) are automation objects too and should likewise be released with `:destroy()`. Methods and properties that pass or return raw byte arrays are not shown on this page; use the `BinData`-based alternatives (methods ending in *Bd*) or the base64 / hex string-encoded variants instead.

Call `Global.UnlockBundle` once at the start of the program, before using this or any other Chilkat class. Any string unlocks a fully functional 30-day trial; a purchased unlock code is used in production. See `guide.md` for the exact code in Xbase++.

How failure is reported depends on the method's return type and is stated in the note under each method below. In every case the diagnostic text is in the `LastErrorText` property of the object whose method was called.

## Members common to every Chilkat class

Documented once per language in `common-members.md`; listed here so this page is self-contained.

| Property | Signature | Access | Meaning |
|---|---|---|---|
| `DebugLogFilePath` | `oMcp:DebugLogFilePath // Character` | read/write | If set to a file path, this property logs the LastErrorText of each Chilkat method or property call to the specified file. |
| `LastErrorHtml` | `oMcp:LastErrorHtml // Character (read-only)` | read-only | Provides HTML-formatted information about the last called method or property. |
| `LastErrorText` | `oMcp:LastErrorText // Character (read-only)` | read-only | Provides plain text information about the last called method or property. |
| `LastErrorXml` | `oMcp:LastErrorXml // Character (read-only)` | read-only | Provides XML-formatted information about the last called method or property. |
| `LastMethodSuccess` | `oMcp:LastMethodSuccess // Numeric` | read/write | Indicates the success or failure of the most recent method call: `1` means success, `0` means failure. |
| `LastStringResult` | `oMcp:LastStringResult // Character (read-only)` | read-only | In SQL Server stored procedures, this property holds the string return value of the most recent method call that returns a string. |
| `LastStringResultLen` | `oMcp:LastStringResultLen // Numeric (read-only)` | read-only | The length, in characters, of the string contained in the LastStringResult property. |
| `VerboseLogging` | `oMcp:VerboseLogging // Numeric` | read/write | If set to `1`, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may contain more verbose information. |
| `Version` | `oMcp:Version // Character (read-only)` | read-only | Version of the component/library, such as "10.1.0" |

## Member index

| Member | Kind | Signature |
|---|---|---|
| `AuthToken` | property, read/write | `oMcp:AuthToken // Character` |
| `Connected` | property, read-only | `oMcp:Connected // Numeric (read-only)` |
| `ConnectTimeoutMs` | property, read/write | `oMcp:ConnectTimeoutMs // Numeric` |
| `IdleTimeoutMs` | property, read/write | `oMcp:IdleTimeoutMs // Numeric` |
| `ProtocolVersion` | property, read/write | `oMcp:ProtocolVersion // Character` |
| `ServerInstructions` | property, read-only | `oMcp:ServerInstructions // Character (read-only)` |
| `ServerName` | property, read-only | `oMcp:ServerName // Character (read-only)` |
| `ServerVersion` | property, read-only | `oMcp:ServerVersion // Character (read-only)` |
| `SessionId` | property, read-only | `oMcp:SessionId // Character (read-only)` |
| `CallTool` | method | `nSuccess := oMcp:CallTool(cName, oArgsJson, oResultJson) // returns Numeric (1/0)` |
| `Close` | method | `nSuccess := oMcp:Close() // returns Numeric (1/0)` |
| `Connect` | method | `nSuccess := oMcp:Connect(cUrl) // returns Numeric (1/0)` |
| `GetLastJsonData` | method | `oMcp:GetLastJsonData(oJson)` |
| `GetPrompt` | method | `nSuccess := oMcp:GetPrompt(cName, oArgsJson, oJson) // returns Numeric (1/0)` |
| `ListPrompts` | method | `nSuccess := oMcp:ListPrompts(oJson) // returns Numeric (1/0)` |
| `ListResources` | method | `nSuccess := oMcp:ListResources(oJson) // returns Numeric (1/0)` |
| `ListTools` | method | `nSuccess := oMcp:ListTools(oJson) // returns Numeric (1/0)` |
| `ReadResource` | method | `nSuccess := oMcp:ReadResource(cUri, oJson) // returns Numeric (1/0)` |
| `SetConnectionSettings` | method | `nSuccess := oMcp:SetConnectionSettings(oSock) // returns Numeric (1/0)` |

## Properties

### Mcp.AuthToken

`Chilkat 11.7.0 · xbase · Mcp · AuthToken · property · read/write · since 11.6.0`

```xbase
oMcp:AuthToken  // Character
```

An optional bearer token for authenticating to the MCP server. When set, it is sent as an `Authorization: Bearer <token>` header on every request. The default is the empty string.

### Mcp.Connected

`Chilkat 11.7.0 · xbase · Mcp · Connected · property · read-only · since 11.6.0`

```xbase
oMcp:Connected  // Numeric (read-only)
```

Read-only. `1` after a successful `Connect` (the `initialize` handshake completed).

### Mcp.ConnectTimeoutMs

`Chilkat 11.7.0 · xbase · Mcp · ConnectTimeoutMs · property · read/write · since 11.6.0`

```xbase
oMcp:ConnectTimeoutMs  // Numeric
```

The maximum amount of time, in milliseconds, to wait to establish the TCP/TLS connection to the MCP server. The default value is `30000` (30 seconds).

### Mcp.IdleTimeoutMs

`Chilkat 11.7.0 · xbase · Mcp · IdleTimeoutMs · property · read/write · since 11.6.0`

```xbase
oMcp:IdleTimeoutMs  // Numeric
```

The maximum amount of time, in milliseconds, to wait for additional incoming data when receiving a response has paused. This is not a total timeout. The default value is `180000` (180 seconds).

### Mcp.ProtocolVersion

`Chilkat 11.7.0 · xbase · Mcp · ProtocolVersion · property · read/write · since 11.6.0`

```xbase
oMcp:ProtocolVersion  // Character
```

The MCP protocol version. May be set before `Connect` to request a specific version; after `Connect` it reflects the version negotiated with the server and is sent in the `MCP-Protocol-Version` header of each request. The default is `2025-06-18`.

### Mcp.ServerInstructions

`Chilkat 11.7.0 · xbase · Mcp · ServerInstructions · property · read-only · since 11.6.0`

```xbase
oMcp:ServerInstructions  // Character (read-only)
```

Read-only. Optional usage instructions provided by the server in the `initialize` result (may be the empty string), available after `Connect`.

### Mcp.ServerName

`Chilkat 11.7.0 · xbase · Mcp · ServerName · property · read-only · since 11.6.0`

```xbase
oMcp:ServerName  // Character (read-only)
```

Read-only. The server name reported in the `initialize` result, available after `Connect`.

### Mcp.ServerVersion

`Chilkat 11.7.0 · xbase · Mcp · ServerVersion · property · read-only · since 11.6.0`

```xbase
oMcp:ServerVersion  // Character (read-only)
```

Read-only. The server version reported in the `initialize` result, available after `Connect`.

### Mcp.SessionId

`Chilkat 11.7.0 · xbase · Mcp · SessionId · property · read-only · since 11.6.0`

```xbase
oMcp:SessionId  // Character (read-only)
```

Read-only. The `Mcp-Session-Id` assigned by the server during the `Connect` handshake, or the empty string if the server is stateless. Chilkat automatically includes this session id on all subsequent requests.

## Methods

### Mcp.CallTool

`Chilkat 11.7.0 · xbase · Mcp · CallTool · method · since 11.6.0`

```xbase
nSuccess := oMcp:CallTool(cName, oArgsJson, oResultJson)  // returns Numeric (1/0)
```

Calls the MCP `tools/call` method for the tool named `name`, passing the JSON arguments object in `argsJson`. The members of `argsJson` are the tool's input arguments and should match the tool's `inputSchema` as returned by `ListTools`. For example, a weather tool might be called with the arguments `{ "location": "Boston, MA", "units": "fahrenheit" }`. Pass an empty JSON object (not a null) for a tool that takes no arguments.

On success, the tool result is placed in `resultJson`. It contains a `content` array, an `isError` boolean, and optionally a `structuredContent` object. Each element of the `content` array has a `type` (`"text"`, `"image"`, `"audio"`, or `"resource"`); for a `"text"` element the value is in its `text` member. A typical result looks like:

```
{
  "content": [ { "type": "text", "text": "The weather in Boston is 72F and sunny." } ],
  "isError": false
}
```

Thus the text of the first content item is at JSON path `content[0].text`.

**Note:** A tool that executes but reports a failure returns `1` here with `isError` set to `1` in `resultJson` (the failure message is typically carried in the `content` array). The return value is `0` only for transport- or protocol-level failures.

`Connect` must be called first.

Returns 1 for success, 0 for failure.

Async variant: `CallToolAsync` — same arguments, returns a `Task` (see Async variants below).

### Mcp.Close

`Chilkat 11.7.0 · xbase · Mcp · Close · method · since 11.6.0`

```xbase
nSuccess := oMcp:Close()  // returns Numeric (1/0)
```

Explicitly terminates the MCP session by sending an HTTP `DELETE` with the `Mcp-Session-Id` header, then releases the connection. It is safe to call this method when not connected (it simply releases any transport). A server that does not permit client-terminated sessions responds with HTTP `405`, which is not treated as an error.

Returns 1 for success, 0 for failure.

Async variant: `CloseAsync` — same arguments, returns a `Task` (see Async variants below).

### Mcp.Connect

`Chilkat 11.7.0 · xbase · Mcp · Connect · method · since 11.6.0`

```xbase
nSuccess := oMcp:Connect(cUrl)  // returns Numeric (1/0)
```

Connects to the MCP (Model Context Protocol) server at the Streamable HTTP endpoint URL in `url` (for example `https://example.com/mcp`) and performs the MCP `initialize` handshake.

On success, the `SessionId`, `ProtocolVersion`, `ServerName`, `ServerVersion`, and `ServerInstructions` properties are populated, and `Connected` becomes `1`.

If an `AuthToken` is set, it is sent as a bearer token on the request. The URL must begin with `http://` or `https://`; the host, port, and path are taken from it. Only the Streamable HTTP transport is supported; the stdio transport is not.

Returns 1 for success, 0 for failure.

Async variant: `ConnectAsync` — same arguments, returns a `Task` (see Async variants below).

### Mcp.GetLastJsonData

`Chilkat 11.7.0 · xbase · Mcp · GetLastJsonData · method · since 11.6.0`

```xbase
oMcp:GetLastJsonData(oJson)
```

Returns, in `json`, the complete JSON-RPC response envelope from the most recent request (the `jsonrpc`, `id`, and `result` or `error` members), for diagnostics and logging. Note that this is the full JSON-RPC envelope, whereas `ListTools`, `CallTool`, `ReadResource`, and `GetPrompt` each return only the inner `result` object.

### Mcp.GetPrompt

`Chilkat 11.7.0 · xbase · Mcp · GetPrompt · method · since 11.6.0`

```xbase
nSuccess := oMcp:GetPrompt(cName, oArgsJson, oJson)  // returns Numeric (1/0)
```

Calls the MCP `prompts/get` method for the prompt named `name`, passing the JSON arguments object in `argsJson` (pass an empty object for a prompt that takes no arguments). On success, the result is placed in `json`, consisting of an optional `description` and a `messages` array in which each message has a `role` and `content`.

`Connect` must be called first.

Returns 1 for success, 0 for failure.

Async variant: `GetPromptAsync` — same arguments, returns a `Task` (see Async variants below).

### Mcp.ListPrompts

`Chilkat 11.7.0 · xbase · Mcp · ListPrompts · method · since 11.6.0`

```xbase
nSuccess := oMcp:ListPrompts(oJson)  // returns Numeric (1/0)
```

Calls the MCP `prompts/list` method. On success, the server's result object is placed in `json`, containing a `prompts` array in which each prompt has a `name`, optionally a `description`, and an `arguments` array, and possibly a `nextCursor` for pagination.

`Connect` must be called first.

Returns 1 for success, 0 for failure.

Async variant: `ListPromptsAsync` — same arguments, returns a `Task` (see Async variants below).

### Mcp.ListResources

`Chilkat 11.7.0 · xbase · Mcp · ListResources · method · since 11.6.0`

```xbase
nSuccess := oMcp:ListResources(oJson)  // returns Numeric (1/0)
```

Calls the MCP `resources/list` method. On success, the server's result object is placed in `json`, containing a `resources` array in which each resource has a `uri`, a `name`, and optionally a `description` and `mimeType`, and possibly a `nextCursor` for pagination.

`Connect` must be called first.

Returns 1 for success, 0 for failure.

Async variant: `ListResourcesAsync` — same arguments, returns a `Task` (see Async variants below).

### Mcp.ListTools

`Chilkat 11.7.0 · xbase · Mcp · ListTools · method · since 11.6.0`

```xbase
nSuccess := oMcp:ListTools(oJson)  // returns Numeric (1/0)
```

Calls the MCP `tools/list` method. On success, the server's result object is placed in `json`, containing a `tools` array in which each tool has a `name`, a `description`, and an `inputSchema` (a JSON Schema describing the tool's arguments), and possibly a `nextCursor` for pagination.

`Connect` must be called first.

Returns 1 for success, 0 for failure.

Async variant: `ListToolsAsync` — same arguments, returns a `Task` (see Async variants below).

### Mcp.ReadResource

`Chilkat 11.7.0 · xbase · Mcp · ReadResource · method · since 11.6.0`

```xbase
nSuccess := oMcp:ReadResource(cUri, oJson)  // returns Numeric (1/0)
```

Calls the MCP `resources/read` method for the resource identified by the URI in `uri`. On success, the result is placed in `json`, containing a `contents` array whose entries carry a `uri`, a `mimeType`, and either `text` (for text resources) or `blob` (base64 for binary resources).

`Connect` must be called first.

Returns 1 for success, 0 for failure.

Async variant: `ReadResourceAsync` — same arguments, returns a `Task` (see Async variants below).

### Mcp.SetConnectionSettings

`Chilkat 11.7.0 · xbase · Mcp · SetConnectionSettings · method · since 11.6.0`

```xbase
nSuccess := oMcp:SetConnectionSettings(oSock)  // returns Numeric (1/0)
```

Copies connection settings, including HTTP proxy, SOCKS proxy, bind (network interface) IP address, and TLS options, from `sock`. This is optional; if not used, default settings apply. Call this method before `Connect`.

Returns 1 for success, 0 for failure.

## Events and callbacks

This binding has no event callbacks. For progress, percent-done or cancellation use the `*Async` variant of a method and poll the returned `Task` (`PercentDone`, `Finished`, `Cancel`).

## Async variants

Each returns a `Task` instead of the result and takes the same arguments as the synchronous method; run the task, wait for `Finished`, then read the result from the task. No new Async methods are added from 11.7.0 on.

```xbase
oTask := oMcp:CallToolAsync(cName, oArgsJson, oResultJson)  // returns ChilkatTask
oTask := oMcp:CloseAsync()  // returns ChilkatTask
oTask := oMcp:ConnectAsync(cUrl)  // returns ChilkatTask
oTask := oMcp:GetPromptAsync(cName, oArgsJson, oJson)  // returns ChilkatTask
oTask := oMcp:ListPromptsAsync(oJson)  // returns ChilkatTask
oTask := oMcp:ListResourcesAsync(oJson)  // returns ChilkatTask
oTask := oMcp:ListToolsAsync(oJson)  // returns ChilkatTask
oTask := oMcp:ReadResourceAsync(cUri, oJson)  // returns ChilkatTask
```

## Related classes

[`JsonObject`](https://www.chilkatsoft.com/ai-docs/v/11.7.0/xbase/classes/JsonObject.md), [`Socket`](https://www.chilkatsoft.com/ai-docs/v/11.7.0/xbase/classes/Socket.md)

