feat: add model-context-protocol-farcaster-voting-server example

[consumeobeydie]

Description

Tests

Checklist

A couple of things to include in your PR for completeness:

• Added documentation to all relevant README.md files
• Added a changelog entry

[cb-heimdall]

🟡 Heimdall Review Status

Requirement	Status	More Info
Reviews	🟡 0/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 1 Sum 2

[consumeobeydie]

What this example does

This MCP server enables AI agents to interact with BaseBookvsMovie — a Farcaster Mini App on Base blockchain that lets users vote for book vs film adaptations and earn 100 CSM tokens per vote.

Tools

• check_available_votes — checks which titles are available for voting for a given wallet address
• build_vote_transaction — builds vote transaction data with Builder Code appended for Base ecosystem attribution

Why this is useful

Demonstrates how to connect AI agents to Farcaster Mini Apps via MCP. The Builder Code pattern shows how agent actions can be attributed to the Base ecosystem.

Live app

https://base-bookvs-movie.vercel.app

Contract: 0x407EacD1aAF2F46cC4079BFC4bef0c197A1FD6A8 (Base Mainnet)