JSDoc: Class: MCPClient

Constructor

new MCPClient(config)

Create a new MCP client

Parameters:

Name Type Description

config

Object | string

Configuration object or URL string

Properties

Name	Type	Attributes	Description
`baseURL`	string	<optional>	MCP server base URL
`serverUrl`	string	<optional>	Alias for baseURL
`timeout`	number	<optional>	Request timeout in milliseconds (default: 30000)
`maxRetries`	number	<optional>	Maximum retry attempts (default: 3)
`authToken`	string	<optional>	Optional authentication token
`headers`	Object	<optional>	Custom HTTP headers to include in all requests

Source:

scripts/mcp-client.js, line 405

Examples

Basic usage with default configuration
const client = new MCPClient();

With custom configuration
const client = new MCPClient({
  baseURL: 'https://custom-mcp-server.com/mcp',
  timeout: 60000,
  maxRetries: 5,
  authToken: 'Bearer xyz...',
  headers: {
    'X-Custom-Header': 'value',
    'X-API-Key': 'abc123'
  }
});

With headers from .github/copilot-mcp.json
// Configuration in .github/copilot-mcp.json:
// {
//   "mcpServers": {
//     "github": {
//       "type": "http",
//       "url": "https://api.githubcopilot.com/mcp/insiders",
//       "headers": {
//         "Authorization": "Bearer ${{ secrets.TOKEN }}",
//         "X-MCP-Toolsets": "all"
//       }
//     }
//   }
// }
// The client will automatically use these headers when configured via MCP

Methods

(async) enrichDocumentsWithContent(documents, concurrency) → {Promise.<Array>}

Batch fetch document details for multiple documents Fetches in parallel with rate limiting to avoid overwhelming the server

Parameters:

Name	Type	Default	Description
`documents`	Array.<Object>		Array of document objects with dok_id
`concurrency`	number	3	Max parallel requests (default: 3)

Source:

scripts/mcp-client.js, line 878

Returns:

Documents with enriched content

Type: Promise.<Array>

(async) fetchCalendarEvents(from, tom, org, akt) → {Promise.<Array>}

Fetch calendar events (upcoming parliamentary activity)

Parameters:

Name	Type	Default	Description
`from`	string		Start date (YYYY-MM-DD)
`tom`	string		End date (YYYY-MM-DD)
`org`	string	null	Optional: Organ filter (e.g., 'kammaren', 'uu', 'fiu')
`akt`	string	null	Optional: Activity type

Source:

scripts/mcp-client.js, line 721

Returns:

Calendar events

Type: Promise.<Array>

(async) fetchCommitteeReports(limit, rm, organ) → {Promise.<Array>}

Fetch latest committee reports (betänkanden)

Parameters:

Name	Type	Default	Description
`limit`	number	10	Number of reports to fetch
`rm`	string	null	Optional: Riksmöte (e.g., '2025/26')
`organ`	string	null	Optional: Committee filter

Source:

scripts/mcp-client.js, line 738

Returns:

Committee reports

Type: Promise.<Array>

(async) fetchDocumentDetails(dok_id, include_full_text) → {Promise.<Object>}

Fetch detailed document with full content

Parameters:

Name	Type	Default	Description
`dok_id`	string		Document ID
`include_full_text`	boolean	true	Include full document text (default: true)

Source:

scripts/mcp-client.js, line 862

Returns:

Document with content

Type: Promise.<Object>

(async) fetchGovernmentDocuments(searchParams) → {Promise.<Array>}

Fetch government documents (pressmeddelanden, SOU, etc.)

Parameters:

Name Type Description

searchParams

Object

Search parameters

Properties

Name	Type	Description
`type`	string	Document type
`title`	string	Title search
`dateFrom`	string	From date
`dateTo`	string	To date
`limit`	number	Result limit

Source:

scripts/mcp-client.js, line 850

Returns:

Government documents

Type: Promise.<Array>

(async) fetchMPs(filters) → {Promise.<Array>}

Fetch MPs (ledamöter)

Parameters:

Name Type Description

filters

Object

Optional filters

Properties

Name	Type	Description
`parti`	string	Party filter
`valkrets`	string	Electoral district
`status`	string	Status filter
`limit`	number	Result limit

Source:

scripts/mcp-client.js, line 820

Returns:

MPs

Type: Promise.<Array>

(async) fetchMotions(limit, rm) → {Promise.<Array>}

Fetch latest opposition motions

Parameters:

Name	Type	Default	Description
`limit`	number	10	Number of motions to fetch
`rm`	string	null	Optional: Riksmöte

Source:

scripts/mcp-client.js, line 769

Returns:

Motions

Type: Promise.<Array>

(async) fetchPropositions(limit, rm) → {Promise.<Array>}

Fetch latest government propositions

Parameters:

Name	Type	Default	Description
`limit`	number	10	Number of propositions to fetch
`rm`	string	null	Optional: Riksmöte

Source:

scripts/mcp-client.js, line 754

Returns:

Propositions

Type: Promise.<Array>

(async) fetchVotingRecords(filters) → {Promise.<Array>}

Fetch voting records

Parameters:

Name Type Description

filters

Object

Filter parameters

Properties

Name	Type	Description
`rm`	string	Riksmöte
`bet`	string	Document reference
`punkt`	string	Voting point

Source:

scripts/mcp-client.js, line 834

Returns:

Voting records

Type: Promise.<Array>

getStats() → {Object}

Get request statistics

Source:

scripts/mcp-client.js, line 951

Returns:

Statistics

Type: Object

(async) initializeSession()

Initialize MCP session for Streamable HTTP transport

Source:

scripts/mcp-client.js, line 653

parseSSEResponse()

Parse SSE (text/event-stream) response body into JSON-RPC response

Source:

scripts/mcp-client.js, line 639

(async) request(tool, params, retryCount) → {Promise.<Object>}

Make HTTP request to MCP server using JSON-RPC 2.0 protocol

Parameters:

Name	Type	Default	Description
`tool`	string		Tool name (e.g., 'get_calendar_events')
`params`	Object		Tool parameters
`retryCount`	number	0	Current retry attempt

Source:

scripts/mcp-client.js, line 446

Returns:

Tool response

Type: Promise.<Object>

resetStats()

Reset statistics

Source:

scripts/mcp-client.js, line 964

(async) searchDocuments(searchParams) → {Promise.<Array>}

Search riksdag documents

Parameters:

Name Type Description

searchParams

Object

Search parameters

Properties

Name	Type	Description
`sok`	string	Search query
`doktyp`	string	Document type (mot, prop, bet, etc.)
`rm`	string	Riksmöte
`from_date`	string	From date
`to_date`	string	To date
`limit`	number	Result limit

Source:

scripts/mcp-client.js, line 789

Returns:

Documents

Type: Promise.<Array>

(async) searchSpeeches(searchParams) → {Promise.<Array>}

Search speeches/debates (anföranden)

Parameters:

Name Type Description

searchParams

Object

Search parameters

Properties

Name	Type	Description
`sok`	string	Search query
`rm`	string	Riksmöte
`talare`	string	Speaker name
`parti`	string	Party
`limit`	number	Result limit

Source:

scripts/mcp-client.js, line 805

Returns:

Speeches

Type: Promise.<Array>

(async) sleep()

Sleep utility

Source:

scripts/mcp-client.js, line 632