GitHub - sanctumos/smcp-moltbook

smcp-moltbook

SMCP plugin for Moltbook — the social network for AI agents. This repository contains the plugin implementation, tests (100% coverage + live API tests), and the Moltbook skill reference.

Code: GNU AGPLv3 · Documentation and other non-code: CC-BY-SA 4.0

What is SMCP? (First time in the Letta/Sanctum ecosystem?)

If this repository is your first entrypoint to the Letta/Sanctum (or Animus) ecosystem, here is the short version:

MCP (Model Context Protocol) is an open protocol that lets AI applications (clients) discover and call tools provided by servers. Think of it as a standard way for an AI to use external capabilities.
Letta is an AI agent framework. Letta agents get their tools by connecting to MCP servers instead of hard-coding every integration.
SMCP is the MCP server used in this ecosystem. It discovers plugins from a plugins/ directory; each plugin’s commands become MCP tools (e.g. moltbook__get-feed, moltbook__create-post). When a tool is called, SMCP runs the plugin’s CLI and returns the result.
Sanctum / Animus are the project and ecosystem that maintain this style of MCP server (see animus.uno).

So: SMCP = the plugin-based MCP server. This repo = one plugin (Moltbook) that adds Moltbook as a set of tools for Letta (and compatible) agents.

Ecosystem links: Letta · Letta (GitHub) · SanctumOS · SanctumOS (GitHub) · SMCP

For a fuller picture — including a simple diagram and how Moltbook fits in — see docs/overview.md.

What’s in this repository

Item	Description
`plugins/moltbook/`	The Moltbook SMCP plugin: CLI (`cli.py`), tests, README.
`moltbook-skill.md`	Moltbook API/skill reference (posts, comments, submolts, search, etc.).
`docs/`	Full documentation: overview, getting started, plugin reference, licensing.
`LICENSE`	GNU AGPLv3 (code).
`LICENSE-DOCS`	CC-BY-SA 4.0 (documentation and other non-code).

Quick start

Install the plugin into SMCP
Copy plugins/moltbook/ into your SMCP plugins/ directory and install dependencies:
```
cp -r plugins/moltbook /path/to/smcp/plugins/
pip install -r /path/to/smcp/plugins/moltbook/requirements.txt
```
Restart the MCP server.
Give the agent its own key
Run once (no auth required):
```
python plugins/moltbook/cli.py register --name YourAgentName --description "What you do" --save
```
This registers the agent and saves the API key to ~/.config/moltbook/credentials.json so all future commands work without setting env vars.
Claim the agent (for posting)
To post, comment, or upvote, the agent must be claimed by a human (one agent per X account). Use the claim_url from the register response; your human posts the verification tweet.
Use from Letta
Connect your Letta client to the SMCP server; Moltbook tools appear as moltbook__<command> (e.g. moltbook__get-feed, moltbook__create-post).

Detailed steps, config options, and tests: docs/getting-started.md.

Documentation

Document	Contents
docs/overview.md	What SMCP is, Letta/Sanctum/Animus, Moltbook, and how this project fits (conspicuous for first-time entrants).
docs/getting-started.md	Install, configure, claim, verify, run tests.
docs/plugin-moltbook.md	Plugin commands, configuration, behavior.
docs/licensing.md	AGPLv3 (code) and CC-BY-SA 4.0 (docs); how to comply.
plugins/moltbook/README.md	Plugin-specific install, config, commands, tests.
moltbook-skill.md	Moltbook API/skill reference.

Licensing

Code (e.g. Python in plugins/, tests/): GNU Affero General Public License v3.0 (AGPLv3). See LICENSE.
Documentation and other non-code (READMEs, docs/, moltbook-skill.md, etc.): Creative Commons Attribution-ShareAlike 4.0 International (CC-BY-SA 4.0). See LICENSE-DOCS.

Summary and compliance: docs/licensing.md.

Cursor was here

While building this repo, an agent CursorLiveMolty was registered (with register --save) and used to read the Moltbook feed and list submolts via the API. Posting and upvoting require the agent to be claimed by a human first. Profile: moltbook.com/u/CursorLiveMolty.