Reference
Tool reference
For developers, and for AI apps reading these docs. You never need to type a tool name. Your AI app picks the right tool from what you ask.
Connection
AI Smith is a remote MCP server. MCP is the standard AI apps use to call outside tools.
- Address
https://app.aismith.my/mcp- Transport
- Streamable HTTP
- Sign-in
- OAuth, with Google as the login. The AI app registers itself automatically. Until the account is approved, tools answer that approval is pending.
- Errors
- Every error carries an
error_codeand anext_steptelling the AI app what to do.
Approval patterns
Anything public takes two calls. The first shows exactly what will happen and returns a token for that exact content. The second does it, and is refused if the content changed.
- Posts
preview_post→publish_postwithconfirm_token(10 minutes)- Replies
draft_comment_reply→send_comment_reply;draft_review_reply→send_review_reply- Rules
preview_comment_to_dm→set_comment_to_dm- Auto-replies
test_auto_replyreturns aswitch_on_token→set_auto_reply_configwithenabled: true
All tools
34 tools. Read changes nothing. Setting changes something private. Needs your yes goes public or reaches customers.
| Tool | What it does | Effect |
|---|---|---|
| Account and connections | ||
| get_account_status | What's set up, what's missing, and which tools this AI app should see. | Read |
| list_social_accounts | Connected accounts and their ids. | Read |
| get_social_connect_link | A browser link to connect a platform. | Read |
| Photos and videos | ||
| upload_image | Store an image from the chat (5 MB). | Setting |
| upload_media | Store a file the user attached (image 32 MB, video 1 GB). | Setting |
| get_upload_link | A one-time upload link, valid 60 minutes. | Setting |
| list_media | Recent uploads (kept 7 days). | Read |
| Posting | ||
| preview_post | The exact post per account, file checks, and a confirm token. | Read |
| publish_post | Publish or schedule the approved post. | Needs your yes |
| get_post_status | Per-platform result and links. | Read |
| list_posts | Recent posts made through AI Smith. | Read |
| delete_post | Take a post down (not Instagram or TikTok). | Needs your yes |
| retry_post | Retry a failed or partly failed post. | Needs your yes |
| get_posting_schedule | Weekly posting times. | Read |
| set_posting_schedule | Save weekly posting times. | Coming soon |
| Automatic replies | ||
| get_auto_reply_config | The stored playbook, rules and switches. | Read |
| set_auto_reply_config | Save the playbook and rules. Switching on needs a fresh test and a yes. | Needs your yes |
| set_auto_reply_account | Replies on or off for one account. | Setting |
| test_auto_reply | The reply the assistant would send. Nothing is sent. | Read |
| list_conversations | Conversations, and which are waiting for a person. | Read |
| get_conversation | The messages in one conversation. | Read |
| resume_conversation | Hand a conversation back to the assistant. | Setting |
| get_inbox_performance | Volume, reply times, busiest hours. | Read |
| Comment-to-DM | ||
| list_comment_to_dm | Rules made through AI Smith, with DM counts. | Read |
| preview_comment_to_dm | The rule as it will run, and a confirm token. | Read |
| set_comment_to_dm | Switch on the approved rule. | Needs your yes |
| stop_comment_to_dm | Switch a rule off for good. | Setting |
| Comments and reviews | ||
| list_comments | Unanswered comments on recent posts. | Read |
| draft_comment_reply | A reply draft and a confirm token. | Read |
| send_comment_reply | Post the approved reply. | Needs your yes |
| hide_comment | Hide or show a comment (reversible). | Setting |
| list_reviews | Unanswered reviews, lowest ratings first if asked. | Read |
| draft_review_reply | A reply draft and a confirm token. | Read |
| send_review_reply | Post the approved reply (Facebook today). | Needs your yes |
If your AI app can't see a tool listed here, it has an old copy of the list. See Troubleshooting.