Knowledge MCP
Connect an agent directly to SignalLedger's public, read-only knowledge runtime.
Endpoint
Transport
Access
Runtime
Connect your agent
Use the environment-aware public endpoint with no access token.
Use the environment-aware public endpoint with no access token.
Connect
The URL is derived from this page, so localhost, preview, and production configurations remain distinct.
[mcp_servers.signalledger-knowledge]
url = "/api/mcp/knowledge"Transport
Streamable HTTP
Endpoint
/api/mcp/knowledge
Read-only tools
3 tools
Public-safe read boundary
This endpoint exposes retrieval, bounded node listing, and graph-neighborhood inspection only. It has no ingestion, mutation, deletion, or private CareerOS data access.
Tool explorer
Generated from the same portable MCP catalog registered by the server.
3 of 3
knowledge_retrievereadstableRetrieve cited knowledge context.
When to use
Use for grounded semantic retrieval with optional graph expansion. The calling agent synthesizes the final answer.
Request example
{
"query": "What did the customer report about onboarding?",
"limit": 5,
"expandDepth": 1
}Representative response
[
{
"id": "knowledge-1",
"score": 0.92,
"citations": [
{
"sourceId": "source-1"
}
]
}
]Input schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Natural-language retrieval query."
},
"limit": {
"type": "number",
"default": 10
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"expandDepth": {
"type": "number",
"default": 1
}
},
"required": [
"query"
],
"additionalProperties": false
}Output schema
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}knowledge_graph_neighborhoodreadstableReturn the graph neighborhood around a node.
When to use
Use after identifying a relevant node to inspect its directly connected context.
Request example
{
"nodeId": "knowledge-1",
"depth": 1
}Representative response
{
"nodes": [
{
"id": "knowledge-1"
}
],
"edges": []
}Input schema
{
"type": "object",
"properties": {
"nodeId": {
"type": "string"
},
"depth": {
"type": "number",
"default": 1
}
},
"required": [
"nodeId"
],
"additionalProperties": false
}Output schema
{
"type": "object",
"additionalProperties": true
}knowledge_list_nodesreadstableList knowledge graph nodes.
When to use
Use for bounded graph discovery before requesting a specific node or neighborhood.
Request example
{
"limit": 25
}Representative response
[
{
"id": "knowledge-1",
"label": "Onboarding feedback",
"kind": "knowledge_item"
}
]Input schema
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 50
}
},
"additionalProperties": false
}Output schema
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}