Personal Site
API ONLINE

Agent Gateway

Access BIM/CAD expertise programmatically. REST API (GET) for any HTTP client, MCP for advanced agents, or plain text for crawlers.

Choose Your Protocol

  • Can you send HTTP GET? → Use the REST API below (recommended)
  • Have MCP client support? → Connect to https://botforge.cc/api/mcp for tool calling
  • Can only read text? → Fetch /llms-full.txt for all content

REST API Recommended

Simple GET endpoints returning JSON. No authentication, no handshake. Works with any HTTP client.

Quick Example

GET https://botforge.cc/api/search?q=BIM&limit=5

// Response: { "data": [...], "meta": { "total": 5, "limit": 5, "query": "BIM" } }
GET/api/search?q=&types=&limit=
Unified search across all content types
GET/api/posts?q=&category=&tag=&limit=
List blog posts
GET/api/posts/{slug}
Full blog post with content
GET/api/projects?tag=&featured=&limit=
List projects
GET/api/projects/{slug}
Full project details
GET/api/knowledge?type=&tag=&limit=
Knowledge base
GET/api/knowledge/{slug}
Full knowledge item
GET/api/author
Author profile (expertise, skills, certifications)
GET/api/services
Consulting services catalog
GET/api/categories
Blog categories with descriptions

MCP Protocol

For agents with MCP client support. Provides tool calling, resources, and prompt templates.

Endpoint
https://botforge.cc/api/mcp
Transport
Streamable HTTP
Server
personal-site-content v1.0.0
Manifest
https://botforge.cc/agent/manifest.json

1. Initialize Connection

{
  "jsonrpc": "2.0",
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "capabilities": {},
    "clientInfo": {
      "name": "your-agent",
      "version": "1.0.0"
    }
  },
  "id": 1
}

2. Call a Tool

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_content",
    "arguments": {
      "query": "BIM implementation",
      "limit": 5
    }
  },
  "id": 2
}

Tools (7)

search_content

Cross-type unified search across blog posts, projects, and knowledge base. Returns scored results.

query (string), types? (array<blog|projects|knowledge>), limit? (number)

search_posts

Search blog posts by query string with optional category filter

query (string), category? (bim | cad | industry | career), limit? (number)

recommend_articles

Semantic article recommendations for a given topic

topic (string), limit? (number)

get_post_content

Fetch the full content of a blog post by its URL slug

slug (string)

get_project_detail

Fetch full project details including content by slug

slug (string)

get_expertise

Query the author expertise in a specific domain. Returns matching expertise areas, skills, and certifications.

domain (string)

list_categories

List all blog categories with human-readable descriptions

(none)

Resources (7)

blog://postsList all published blog posts as JSON
blog://posts/{slug}Single blog post content as markdown
projects://listAll projects as JSON
projects://detail/{slug}Single project content as markdown
site://authorAuthor profile (expertise, skills, certifications)
site://servicesConsulting services list
site://aboutSite description as markdown

Prompt Templates (3)

summarize_expertise

Generate a comprehensive expertise summary from profile and published content

focus? (string)

recommend_articles

Curated article recommendations tailored to topic and audience level

topic (string), audience? (string)

explain_service

Detailed explanation of consulting services with scope, deliverables, and fit

service_id? (string), context? (string)

Alternative Access

Not using MCP? These endpoints provide content in simpler formats:

/llms.txtLLM Content Index
Concise site overview for LLM crawlers
/llms-full.txtFull Content Dump
All published content as plain text (dynamic)
/feed.xmlRSS Feed
Blog posts in RSS 2.0 format
/sitemap.xmlSitemap
All pages with priority and change frequency
/.well-known/ai-agent.jsonAgent Discovery
Static agent capability advertisement
/agent/manifest.jsonMCP Manifest
Complete capability manifest (JSON)

Discovery Signals

Every HTTP response from this site includes these headers for automatic MCP discovery:

Link: </api/mcp>; rel="service"; title="MCP Content Server"
Link: </agent>; rel="agent-guide"

# AI agents also receive:
X-Agent-Protocol: MCP/1.0; endpoint=/api/mcp; guide=/agent; manifest=/agent/manifest.json