# search_knowledge

Search the Pirate Skills knowledge: the Growth Codex, the Builder Codex and Insights. Returns the best matching chapters with a link; for a signed-in person each also carries a short excerpt. Without sign-in it returns titles and links only (which codex, the title, the url): the person signs in for the excerpts. Cite the url of every chapter you use in your answer.

Public – no key needed · Read only

## Input

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `query` | `string` | Yes | 2–200 characters |
| `limit` | `integer` | No – default `5` | 1–20 |

## Over HTTP

```bash
curl -X POST https://pirateskills.com/api/public/agent/tools/search_knowledge \
  -H "content-type: application/json" \
  -d '{ "query": "<query>" }'
```

## From the CLI

```bash
pirateskills run search_knowledge --json '{ "query": "<query>" }'
```

## Over MCP

Call `search_knowledge` on `https://pirateskills.com/mcp`. [Connect over MCP](https://pirateskills.com/docs/mcp)

## JSON Schema

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "limit": {
      "default": 5,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ]
}
```

---
Source: https://pirateskills.com/docs/tools/search_knowledge · All docs: https://pirateskills.com/docs.md · Short overview: https://pirateskills.com/llms.txt