youspot

The official Ruby client for YouSpot, the AI-native personal CRM. Standard library only, Ruby 2.7 or newer.

gem install youspot

Everything except call_tool works with no credential. Every YouSpot tool reads one person's own contacts, companies, notes and files, so a token always belongs to a person: mint one at youspot.com/user/mcp and set YOUSPOT_TOKEN, or follow the OAuth 2.1 flow in auth.md.

require "youspot"

client = YouSpot::Client.new

answer = client.ask("how do I connect an MCP client", limit: 3)
answer["results"].each { |hit| puts "#{hit["name"]}: #{hit["url"]}" }

client.tools                                                          # every tool on the product server
client.call_sandbox_tool("search_graph_objects", { query: "Meridian" })  # the demo account, no credential
client.call_tool("get_connections_summary")                           # needs YOUSPOT_TOKEN
client.batch([{ id: "dir", path: "/api/network/members", query: { q: "consulting" } }])

Method	What it does	Credential
index	Every endpoint, and what each one costs in credentials	none
ask	A question about YouSpot, answered from its own pages	none
search_docs, read_doc, list_docs	The developer docs over the documentation MCP server	none
read_markdown	Any public page as markdown	none
tools	The tools on the product MCP server	none
call_tool	One tool, as the member whose token the client holds	YOUSPOT_TOKEN
sandbox_tools, call_sandbox_tool	The read tools over a demo account	none
member, directory	Public profiles and the public directory	none
batch	Up to 20 reads in one round trip	none
identity	What identity the caller can hold here	optional

Every failure raises YouSpot::Error carrying status, the stable code and the url. YOUSPOT_BASE_URL overrides the origin.

The machine descriptions this client follows: openapi.json, the MCP server card, agents.md and llms.txt. Developer docs: https://youspot.com/docs.

MIT licensed. Support: [email protected].