SDK Overview
Client libraries for embedding MisarBlog content and calling the MisarBlog developer API.
Overview
MisarBlog ships client SDKs across 13 targets. Every SDK provides the embed helpers — generate an embed URL (or inject an <iframe> / Flutter widget) for a profile or a single post, and refresh the session token used by gated embeds. All twelve language SDKs additionally ship a full API client for reading and managing content programmatically, and a dedicated MCP client wraps the MCP server.
API base URL
The API clients talk to the developer API:
https://api.misar.io/blog/v1The gateway strips the /api prefix, so the base is /blog/v1 (not /blog/api/v1). Resource paths are appended (/articles, /series, /search, …).
Authentication
The API client authenticates with a key that starts with mbk_ — generate one from Dashboard → Settings → API Keys (see API Keys & Scopes). OAuth 2.1 access tokens are accepted on the same header.
Authorization: Bearer mbk_YOUR_API_KEYThe embed helpers need no API key: embed URLs point at the public viewer, and token refresh takes an existing session token.
SDK Matrix
| Language | Package | Install | API client |
|---|---|---|---|
| TypeScript / JavaScript | @misar/blog | npm install @misar/blog | ✅ |
| Python | misarblog | pip install misarblog | ✅ |
| Go | github.com/misar-ai/misarblog-go | go get github.com/misar-ai/misarblog-go | ✅ |
| Rust | misarblog-sdk | Cargo | ✅ |
| Java | blog.misar:misarblog-sdk | Maven / Gradle | ✅ |
| Kotlin | blog.misar:misarblog-sdk | Gradle | ✅ |
| Swift | MisarBlog | Swift Package Manager | ✅ |
| C# | Misar.Blog | NuGet | ✅ |
| PHP | misarblog/sdk | composer require misarblog/sdk | ✅ |
| Ruby | misarblog | gem install misarblog | ✅ |
| Dart | misarblog_sdk | pub.dev | ✅ |
| Flutter | misarblog_flutter | pub.dev | ✅ |
| MCP client | @misarblog/mcp | npm install @misarblog/mcp | MCP |
Capabilities by SDK
- Embed — every SDK: build an embed URL (or inject an iframe / Flutter widget) for a profile or an individual post.
- Token refresh — every SDK: refresh the session token used for gated / paywalled embeds.
- Full API client — all twelve language SDKs (TypeScript, Python, Go, Rust, Java, Kotlin, Swift, C#, PHP, Ruby, Dart, Flutter): construct a client with your
mbk_key and call resources for articles, series, reactions, AI (titles + completion), images, analytics, profile, plan, and trial. - MCP client —
@misarblog/mcp: drive the MisarBlog MCP server from any MCP-compatible AI client or your own code.