API Documentation

Everything you need to integrate with NowBind's Agent API, MCP server, and platform features.

Getting Started

The NowBind API lets AI agents and applications read posts, search content, and interact with the platform programmatically. Every published post is available as both a human-readable article and a structured AI-agent feed.

Quick start: Create an API key from your API Keys page, then use it in the Authorization header.

Authentication

Include your API key in the Authorization header as a Bearer token. Keys use the nb_ prefix.

cURL Example

curl -H "Authorization: Bearer nb_your_api_key" \
  https://nowbind.com/api/v1/agent/posts

Security: Keep your API keys secret. Never expose them in client-side code or public repositories.

Agent API

Endpoints designed for AI agents to read and search content. All require API key authentication.

GET/api/v1/agent/postsAPI Key

GET/api/v1/agent/posts/{slug}API Key

GET/api/v1/agent/search?q={query}API Key

GET/api/v1/agent/authorsAPI Key

GET/api/v1/agent/tagsAPI Key

List Posts

GET /api/v1/agent/posts

[
  {
    "slug": "my-post",
    "title": "My Post",
    "subtitle": "Optional subtitle",
    "author": "Alice",
    "excerpt": "Brief summary...",
    "reading_time": 5,
    "published_at": "2025-01-01T00:00:00Z",
    "tags": ["go", "backend"],
    "keywords": ["keyword1", "keyword2"],
    "url": "https://nowbind.com/post/my-post",
    "content_url": "https://nowbind.com/api/v1/agent/posts/my-post"
  }
]

Get Post

Returns structured markdown as plain text with Content-Type: text/markdown.

GET /api/v1/agent/posts/{slug}

# My Post

*Optional subtitle*

**Author:** Alice
**Reading Time:** 5 min
**Keywords:** keyword1, keyword2

---

Full markdown content...

Search Posts

Full-text search across titles, content, and AI-generated summaries using PostgreSQL's tsvector.

GET /api/v1/agent/search?q=kubernetes

{
  "query": "kubernetes",
  "total": 12,
  "results": [
    {
      "slug": "kubernetes-guide",
      "title": "Kubernetes Guide",
      "excerpt": "Production-ready Kubernetes setup...",
      "url": "https://nowbind.com/post/kubernetes-guide"
    }
  ]
}

MCP Server

NowBind provides an MCP (Model Context Protocol) server that lets AI assistants like Claude interact with your content directly via JSON-RPC 2.0 over Streamable HTTP.

Endpoint: https://nowbind.com/mcp/

Agent Configurations

Claude Code (CLI)

.claude/settings.json

{
  "mcpServers": {
    "nowbind": {
      "url": "https://nowbind.com/mcp/",
      "headers": {
        "Authorization": "Bearer nb_your_api_key"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "nowbind": {
      "url": "https://nowbind.com/mcp/",
      "headers": {
        "Authorization": "Bearer nb_your_api_key"
      }
    }
  }
}

GitHub Copilot (VS Code)

.vscode/settings.json

{
  "github.copilot.chat.mcp.servers": {
    "nowbind": {
      "type": "http",
      "url": "https://nowbind.com/mcp/",
      "headers": {
        "Authorization": "Bearer nb_your_api_key"
      }
    }
  }
}

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "nowbind": {
      "url": "https://nowbind.com/mcp/",
      "headers": {
        "Authorization": "Bearer nb_your_api_key"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "nowbind": {
      "serverUrl": "https://nowbind.com/mcp/",
      "headers": {
        "Authorization": "Bearer nb_your_api_key"
      }
    }
  }
}

Continue.dev

~/.continue/config.yaml

mcpServers:
  - name: nowbind
    url: https://nowbind.com/mcp/
    headers:
      Authorization: "Bearer nb_your_api_key"

Cline (VS Code)

In VS Code, open Cline settings → MCP Servers → Add Remote Server:

Cline MCP Config

Server URL: https://nowbind.com/mcp/
Header: Authorization: Bearer nb_your_api_key

OpenAI Codex CLI

codex CLI

codex --mcp-config '{"nowbind":{"url":"https://nowbind.com/mcp/","headers":{"Authorization":"Bearer nb_your_api_key"}}}'

Resources

nowbind://postsBrowse all published posts

nowbind://posts/{slug}Read a specific post

nowbind://authorsList all authors

nowbind://tagsBrowse all tags

nowbind://feedRecent posts feed

Tools

search_postsFull-text search across all content

get_postGet a specific post by slug

list_postsList posts with optional tag filter

get_authorGet author info by username

Rate Limits

Rate limits are enforced at multiple levels to prevent abuse.

Global (per IP)200 req/min

Auth endpoints (per IP)10 req/min

Agent API (per API key)100 req/min

MCP Server (per API key)100 req/min

Status when exceeded429 Too Many Requests

Retry headerRetry-After: 60

Command Palette