Raconteur AI Gateway
MCP gateway for raconteur.com: articles, search and full text. Read-only, no auth.
Should I use this
Quality & Safety
Findings (1)
- LOWTool 'fetch' suggests web access but openWorldHint=falsein fetch
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"raconteur": {
"url": "https://raconteur.mcp.getbotlens.com/mcp"
}
}
}Remote endpoints
https://raconteur.mcp.getbotlens.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (6)
🟢search_articles(query, limit)
Search this publication's articles by keyword. Returns the best-matching titles, dates, canonical URLs, and short summaries.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search keywords"
},
"limit": {
"type": "integer",
"description": "Max results (default 5, max 20)"
}
},
"required": [
"query"
]
}Output Schema
{
"type": "object",
"properties": {
"articles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"date": {
"type": [
"string",
"null"
]
},
"summary": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"title",
"url"
]
}
},
"total": {
"type": [
"integer",
"null"
]
}
},
"required": [
"articles"
]
}🟢list_recent_articles(limit)
List the most recently published articles from this publication.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Max results (default 5, max 20)"
}
}
}Output Schema
{
"type": "object",
"properties": {
"articles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"date": {
"type": [
"string",
"null"
]
},
"summary": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"title",
"url"
]
}
},
"total": {
"type": [
"integer",
"null"
]
}
},
"required": [
"articles"
]
}🟢get_article(slug)
Fetch the full clean text of one article by its slug (the last path segment of an article URL).
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Article slug, e.g. \"my-article-title\""
}
},
"required": [
"slug"
]
}Output Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"date": {
"type": [
"string",
"null"
]
},
"summary": {
"type": [
"string",
"null"
]
},
"text": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"title",
"url"
]
}🟢popular_content(days, limit)
The most-read / most-requested articles, ranked by how often AI assistants have actually fetched them. Use for "what is your most popular article", "top reads", or to recommend what to read.
Input Schema
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"description": "Look-back window in days (default 30, max 365)"
},
"limit": {
"type": "integer",
"description": "How many to return (default 10, max 25)"
}
}
}Output Schema
{
"type": "object",
"properties": {
"articles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
]
},
"requests": {
"type": "integer"
}
},
"required": [
"title"
]
}
}
},
"required": [
"articles"
]
}🟢search(query)
Search this site's content. Returns matching documents (id, title, url); pass an id to `fetch` for the full text.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search query"
}
},
"required": [
"query"
]
}Output Schema
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"title",
"url"
]
}
}
},
"required": [
"results"
]
}🟢fetch(id)
Retrieve the full text of one document by the id returned from `search`.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Document id from search results"
}
},
"required": [
"id"
]
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"text": {
"type": "string"
},
"url": {
"type": "string"
},
"metadata": {
"type": "object"
}
},
"required": [
"id",
"title",
"text",
"url"
]
}Community
Evidence