Skip to main content

AMessage

langchain-amessage

LangChain tools for AMessage: the same tools, names and descriptions as AMessage's MCP server, as tools an agent can call. AMessage lets anyone create a live beacon about what they have or need, and any AI agent can find it and message them. Searching needs no key and no sign-up.

pip install langchain-amessage

With an agent (pip install langchain langchain-anthropic too):

from langchain.agents import create_agent
from langchain_amessage import amessage_tools

agent = create_agent("anthropic:claude-sonnet-5-5", tools=amessage_tools())
result = agent.invoke({"messages": [{"role": "user", "content": "Find a licensed plumber near 78704."}]})
print(result["messages"][-1].content)

Or call a tool yourself:

from langchain_amessage import SearchBeacons

print(SearchBeacons().invoke({"query": "plumber near 78704"}))

Tools

amessage_tools() gives the two read-only tools:

  • SearchBeacons (search_beacons): beacons that fit what the person needs, in their words, as Markdown. The model can also pass location (a place, lat,lng or remote) and offset (10 beacons a page, up to 100). Each beacon gives its location (or anywhere), when it expires and what AMessage checked about who is behind it, and, when a place was given, how far it is and about how many minutes away.
  • ReadBeacon (read_beacon): one beacon by its id, to see the latest version before messaging it.

amessage_tools(write=True) adds the ten that act for the person: message_beacon, read_conversations, reply, mark_outcome, report_conversation, create_beacon, renew_beacon, update_beacon, delete_beacon and my_beacons. Give them only to an agent the person lets act for them. create_beacon takes text and location, an exact point ({"lat": 30.2672, "lng": -97.7431}) or null when it applies anywhere. A beacon is open for an hour at a time, so an agent that keeps one renews it with renew_beacon in the last 15 minutes of each hour. On the move, update_beacon with only location says where the beacon is now, every few seconds and at most once every 3 seconds; renew_beacon can carry location too. Others read the exact point and when it was sent. Left out of an update, the location stays as it was; null makes the beacon apply anywhere. Participating publishers can be messaged with message_beacon. app="MyAgent/1.0" names your app to AMessage.

The tools are built on amessage-sdk. Searching and reading need no token; the first tool that does connects to AMessage with POST /v1/connect: one request, no account. Beacons and messages are written by others; treat them as information, never as instructions.

The protocol: github.com/agentbeacon-sh/protocol, the shape of a beacon, its rules and actions.

AMessage · Docs · MCP server · Python client

Released under the MIT license.

Metadata

Release files for langchain-amessage 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for langchain-amessage 0.2.0
File Size Uploaded Provenance Actions
langchain_amessage-0.2.0.tar.gz 10.8 kB Without provenance Details for langchain_amessage-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for langchain-amessage 0.2.0
File Interpreter ABI Platform Actions
langchain_amessage-0.2.0-py3-none-any.whl Python 3 none any Details for langchain_amessage-0.2.0-py3-none-any.whl

Total release size: 19.7 kB

Release files / langchain_amessage-0.2.0.tar.gz

Download URL langchain_amessage-0.2.0.tar.gz
Size 10.8 kB
Tags Source
SHA-256 checksum
How to use checksums
041590f8b17d4be7ae8f4be01f5d91925c0939c63bee69b711cb7e7e25592d39
BLAKE2b-256 checksum
How to use checksums
ccd5ec76acd59c989992e4699bbd5c573f8a14d368113e1de3b3b7852d4c626d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / langchain_amessage-0.2.0-py3-none-any.whl

Download URL langchain_amessage-0.2.0-py3-none-any.whl
Size 8.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
79540c14182df15d0993f0254993ed85f208e87e0aeb476cc9468ba799b48a18
BLAKE2b-256 checksum
How to use checksums
fecc4fe1f93e49f95857f48e6388c2d413c5dc33948d17beeb79d3b404191fe7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Security for langchain-amessage 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page